Share via

3.2.4.4.1.64 IVolumeClient::DeleteAccessPath (Opnum 81)

  • Article

The DeleteAccessPath method deletes a specified mount point from a volume, a partition, or a logical drive.

 HRESULT DeleteAccessPath(
   [in] LdmObjectId volumeId,
   [in] int cch_path,
   [in, size_is(cch_path)] WCHAR* path
 );

volumeId: Specifies the object identifier of the volume, partition, or logical drive from which to delete the mount point.

cch_path: Length of path in characters, including the terminating null character.

path: Null-terminated path of the mount point to delete.

Return Values: The method MUST return 0 or a nonerror HRESULT on success, or an implementation-specific nonzero error code on failure (as specified in [MS-ERREF]; see also section 2.2.1 for HRESULT values predefined by the Disk Management Remote Protocol).

Upon receiving this message, the server MUST validate parameters:

  1. Verify that the volume, partition, or logical drive specified by volumeId is in the list of storage objects.

  2. Verify that path is not NULL.

If parameter validation fails, the server MUST fail the operation immediately, returning an appropriate error as its response to the client.

Otherwise, the server MUST process the message as follows:

  1. Delete the mount point specified by path from the volume, partition, or logical drive specified by volumeId.

  2. Wait for the operation to succeed or fail.

  3. Return a response to the client that contains the status of the operation.