3.4.5.2.26.2 IVdsAdvancedDisk3::GetUniqueId (Opnum 4)

  • Article

The GetUniqueId method<104> retrieves the device path that the operating system uses to identify the disk.

 HRESULT GetUniqueId(
   [out, string] LPWSTR* ppwszId
 );

ppwszId: A pointer to a null-terminated Unicode device path that the operating system uses to identify the device 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 ppwszId is not NULL.

The server MUST set the ppwszId parameter to the address of a null-terminated Unicode string and then return an HRESULT that indicates success or failure.