Share via

3.4.5.2.6.1 IVdsServiceUninstallDisk::GetDiskIdFromLunInfo (Opnum 3)

  • Article

The GetDiskIdFromLunInfo method retrieves the VDS object ID of a disk that corresponds to a specified LUN information structure.

 HRESULT GetDiskIdFromLunInfo(
   [in] VDS_LUN_INFORMATION* pLunInfo,
   [out] VDS_OBJECT_ID* pDiskId
 );

pLunInfo: A pointer to a VDS_LUN_INFORMATION structure that stores the disk's LUN information.

pDiskId: A pointer to a VDS_OBJECT_ID structure that, if the operation is successfully completed, receives the VDS object ID of the disk object that corresponds to the LUN information that pLunInfo specifies.

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 parameters:

  • Verify that pLunInfo is not NULL.

  • Verify that pDiskId is not NULL.

The server MUST set pDiskId to the VDS object identifier of the disk that matches the LUN information that pLunInfo specifies, and return an HRESULT that indicates failure or success.