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

Return Values: QueryFreeExtents MUST return zero to indicate success, or animplementation-specific, nonzero error code to indicate failure.Free extents are not returned for CD/DVD, or super floppy devices.If the disk has no partition format (it is not formatted as either MBR or GPT), then this methodMUST return VDS_E_DISK_NOT_INITIALIZED.When the server receives this message, it MUST validate the following parameters:•Verify that the ppFreeExtentArray parameter is not NULL.•Verify that the plNumberOfFreeExtents parameter is not NULL.The server MUST point ppFreeExtentArray to an array of VDS_DISK_FREE_EXTENT structuresthat contain information about each disk extent on the disk, point plNumberOfFreeExtents to thenumber of elements in the array, and return an HRESULT indicating failure or success.3.4.5.2.23 IVdsAdvancedDisk Methods3.4.5.2.23.1 IVdsAdvancedDisk::GetPartitionProperties (Opnum 3)The GetPartitionProperties method retrieves the properties of a partition on the disk at aspecified byte offset.HRESULT GetPartitionProperties([in] ULONGLONG ullOffset,[out] VDS_PARTITION_PROP* pPartitionProp);ullOffset: The byte offset of the partition, from the beginning of the disk. This offset MUST bethe offset of a start of a partition.pPartitionProp: A pointer to a VDS_PARTITION_PROP structure that, if the operation issuccessfully completed, receives the properties of the partition.Return Values: The method MUST return zero or a non-error HRESULT (as specified in [MS-ERREF]) to indicate success, or return an implementation-specific nonzero error code toindicate failure. For the HRESULT values predefined by the Virtual Disk Service RemoteProtocol, see section 2.2.3.Note This method is not valid for CD/DVD or super floppy devices.When the server receives this message, it MUST validate the following parameter:•Verify that pPartitionProp is not NULL.The server MUST populate the VDS_PARTITION_PROP structure that pPartitionProp referenceswith the properties of the partition at the byte offset from the beginning of the disk that ullOffsetspecifies. The server MUST then return an HRESULT indicating failure or success. For information onVDS_PARTITION_PROP, see section 2.2.1.3.20.3.4.5.2.23.2 IVdsAdvancedDisk::QueryPartitions (Opnum 4)The QueryPartitions method enumerates a disk's partitions.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011211 / 360