13.07.2015 Views

[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification

[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification

[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

HRESULT QueryPartitions([out, size_is(,*plNumberOfPartitions)]<strong>VDS</strong>_PARTITION_PROP** ppPartitionPropArray,[out] long* plNumberOfPartitions);ppPartitionPropArray: A pointer to an array of <strong>VDS</strong>_PARTITION_PROP structures that, if theoperation is successfully completed, receives the array of partition properties.plNumberOfPartitions: A pointer to a variable that, if the operation is successfully completed,receives the total number of elements in ppPartitionPropArray.Return Values: The method MUST return zero or a non-error HRESULT (as specified in [<strong>MS</strong>-ERREF]) to indicate success, or return an implementation-specific nonzero error code toindicate failure. For the HRESULT values predefined by the <strong>Virtual</strong> <strong>Disk</strong> <strong>Service</strong> Remote<strong>Protocol</strong>, see section 2.2.3.Note This method is not valid for CD/DVD or super floppy devices. These devices do notsupport partition tables.When the server receives this message, it MUST validate the following parameters:•Verify that ppPartitionPropArray is not NULL.•Verify that plNumberOfPartitions is not NULL.The server MUST point ppPartitionPropArray to an array of <strong>VDS</strong>_PARTITION_PROP structuresthat contains information about each partition on the disk, point plNumberOfPartitions to thenumber of elements in the array, and then return an HRESULT indicating failure or success.If the disk has no partition format (it is not formatted as either MBR or GPT), then there are nopartitions and this method MUST return <strong>VDS</strong>_E_DISK_NOT_INITIALIZED.3.4.5.2.23.3 IVdsAdvanced<strong>Disk</strong>::CreatePartition (Opnum 5)The CreatePartition method creates a partition on a disk at a specified byte offset.HRESULT CreatePartition([in] ULONGLONG ullOffset,[in] ULONGLONG ullSize,[in] CREATE_PARTITION_PARAMETERS* para,[out] IVdsAsync** ppAsync);ullOffset: MUST be the byte offset from the beginning of the disk at which to create the newpartition.The partition is created at or beyond the ullOffset such that the offset is divisible by thedefault alignment value of the disk. The offset value returned in the server's partitionnotification, after CreatePartition is successful, reflects the rounded-up value.ullSize: MUST be the size of the new partition, in bytes.para: MUST be a pointer to a CREATE_PARTITION_PARAMETERS structure that describes thenew partition to create.[<strong>MS</strong>-<strong>VDS</strong>] — v20110610<strong>Virtual</strong> <strong>Disk</strong> <strong>Service</strong> (<strong>VDS</strong>) <strong>Protocol</strong> <strong>Specification</strong>Copyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011212 / 360

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!