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

);ppExtentArray: A pointer to an array of VDS_DISK_EXTENT structures that, if the operation issuccessfully completed, receives the array of disk extent properties.plNumberOfExtents: A pointer to a variable that, if the operation is successfully completed,receives the total number of elements in ppExtentArray.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 Free extents are not returned for CD/DVD or super floppy devices.When the server receives this message, it MUST validate the following parameters:•Verify that ppExtentArray is not NULL.•Verify that plNumberOfExtents is not NULL.The server MUST point ppExtentArray to an array of VDS_DISK_EXTENT structures containinginformation about each disk extent on the disk, point plNumberOfExtents to the number ofelements in the array, and return an HRESULT indicating failure or success.For removable media drives, the server MUST set the value of volumeId and plexId in theVDS_DISK_EXTENT structure to the VDS_OBJECT_ID of the volume and volume plex objectassociated with the drive.For removable media drives with no media, the server MUST return a single extent of typeVDS_DET_UNKNOWN with the values of ullOffset and ullSize set to 0.3.4.5.2.20.5 IVdsDisk::ConvertStyle (Opnum 7)The ConvertStyle method converts a disk's partitioning format.HRESULT ConvertStyle([in] VDS_PARTITION_STYLE NewStyle);NewStyle: A value from the VDS_PARTITION_STYLE enumeration that indicates the newpartitioning format.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 convert the disk's partitioning format to the styleNewStyle specifies and then return an HRESULT indicating failure or success.A dynamic disk cannot be converted between GPT and MBR partitioning styles. The dynamic diskMUST be converted to a basic disk, at which point it can be converted between partitioning styles.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011207 / 360