3.4.5.2.21.3 IVdsDisk::GetIdentificationData (Opnum 5)

  • Article

The GetIdentificationData method retrieves information that uniquely identifies a disk.

 HRESULT GetIdentificationData(
   [out] VDS_LUN_INFORMATION* pLunInfo
 );

pLunInfo: A pointer to a VDS_LUN_INFORMATION structure that, if the operation is successfully completed, receives the LUN information for the disk.

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

The server MUST populate the VDS_LUN_INFORMATION structure that pLunInfo references with the LUN information that uniquely identifies the disk; it MUST then return an HRESULT indicating failure or success. For information on VDS_LUN_INFORMATION, see section 2.2.1.3.16.