3.4.5.2.33.1 IVdsVolume2::GetProperties2 (Opnum 3)

  • Article

The GetProperties2 method retrieves the properties of the volume that is represented by the object exposing this interface and method.

 HRESULT GetProperties2(
   [out] VDS_VOLUME_PROP2 *pVolumeProperties
 );

pVolumeProperties: A pointer to a VDS_VOLUME_PROP2 (section 2.2.2.15.1.1) structure that, if the operation is successfully completed, receives the properties of the volume.

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.

When the server receives this message, it MUST validate the following parameter:

  • Verify that pVolumeProperties is not NULL.

The server MUST populate the VDS_VOLUME_PROP2 structure that pVolumeProperties references with the properties of the volume, and return an HRESULT indicating failure or success.