Share via

3.4.5.2.21.2 IVdsDisk::GetPack (Opnum 4)

  • Article

The GetPack method retrieves the disk pack that the disk belongs to.

 HRESULT GetPack(
   [out] IVdsPack** ppPack
 );

ppPack: A pointer to an IVdsPack interface that, if the operation is successfully completed, receives the IVdsPack interface of the pack object that the disk 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 ppPack is not NULL.

The server MUST point ppPack to an IVdsPack interface of the pack object that the disk object's pack pointer refers to, and then return an HRESULT indicating failure or success.

If the disk has no partition format (it is not formatted as either MBR or GPT), then there is no associated pack and this method MUST return VDS_E_DISK_NOT_INITIALIZED.