Share via

3.4.5.2.36.1 IVdsVolumeMF3::QueryVolumeGuidPathnames (Opnum 3)

  • Article

The QueryVolumeGuidPathnames method returns a volume's volume GUID path names.

 HRESULT QueryVolumeGuidPathnames(
   [out, string, size_is(,*pulNumberOfPaths)] 
     LPWSTR** pwszPathArray,
   [out] ULONG* pulNumberOfPaths
 );

pwszPathArray: Returns an array of null-terminated Unicode strings; one string for each volume GUID path name associated with the volume.

pulNumberOfPaths: Returns the number of volume GUID path names returned in pwszPathArray.

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

  • Verify that pulNumberOfPaths is not NULL.

The server MUST then perform the following:

  • Allocate a buffer to hold the volume GUID path names associated with the volume, and initialize pwszPathArray with the address of the buffer.

  • Populate the output buffer with the volume GUID path names. Set the value of pulNumberOfPaths to the number of the volume GUID path names being returned.

  • Return an HRESULT indicating failure or success.