3.4.5.2.40.4 IVdsVDisk::GetDeviceName (Opnum 6)

  • Article

The GetDeviceName method returns the device name of the disk.

 HRESULT GetDeviceName(
   [out, string] LPWSTR* ppDeviceName
 );

ppDeviceName: A pointer to a variable that receives the device name of the disk.

Return Values: The method MUST return zero to indicate success, or return an implementation-specific nonzero error code to indicate failure.

When the server receives this message, it MUST validate the following parameter:

  • Verify that ppDeviceName is not NULL.

The server MUST perform the following:

  • If the virtual disk is an attached state, ppDeviceName MUST be set to the device name of the disk associated with the virtual disk. For information on the attached state of a virtual disk, see VDS_VDISK_STATE (section 2.2.2.19.1.1).

  • If the virtual disk is not in an attached state, ppDeviceName MUST be set to NULL.

  • Return an HRESULT indicating failure or success.