3.4.5.2.34.4 IVdsVolumeMF::QueryAccessPaths (Opnum 6)

  • Article

The QueryAccessPaths method returns a list of access paths and a drive letter as a single case-insensitive Unicode character, if one exists, for the current volume.

 HRESULT QueryAccessPaths(
   [out, string, size_is(,*plNumberOfAccessPaths)] 
     LPWSTR** pwszPathArray,
   [out] long* plNumberOfAccessPaths
 );

pwszPathArray: A pointer to an array of strings that, if the operation is successfully completed, receives the array of access paths.

plNumberOfAccessPaths: A pointer to a variable that, if the operation is successfully completed, receives the total number of elements 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 parameters:

  • Verify that pwszPathArray is not NULL.

  • Verify that plNumberOfAccessPaths is not NULL.

If parameter validation fails, the server MUST fail the operation immediately, returning a vendor-specific error as its response to the client.

The server MUST point pwszPathArray to an array of strings that contains the access paths to the volume, point plNumberOfAccessPaths to the size of the array, and return an HRESULT indicating failure or success.