3.4.5.2.24.1 IVdsAdvancedDisk::GetPartitionProperties (Opnum 3)

  • Article

The GetPartitionProperties method retrieves the properties of a partition on the disk at a specified 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 be the offset of a start of a partition.

pPartitionProp: A pointer to a VDS_PARTITION_PROP structure that, if the operation is successfully 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 to indicate failure. For the HRESULT values predefined by the Virtual Disk Service Remote Protocol, 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 references with the properties of the partition at the byte offset from the beginning of the disk that ullOffset specifies. The server MUST then return an HRESULT indicating failure or success. For information on VDS_PARTITION_PROP, see section 2.2.1.3.20.