3.4.5.2.39.2 IVdsVolumePlex::GetVolume (Opnum 4)

  • Article

The GetVolume method retrieves the volume that the volume plex belongs to.

 HRESULT GetVolume(
   [out] IVdsVolume** ppVolume
 );

ppVolume: A pointer to an IVdsVolume interface that, if the operation is successfully completed, receives the IVdsVolume interface of the volume object that the volume plex belongs to. Callers MUST release the interface when they are done with it.

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 ppVolume is not NULL.

The server MUST point ppVolume to an IVdsVolume interface of the volume object that the volume plex object's volume pointer refers. The server MUST then return an HRESULT indicating failure or success.