IVdsVolumeMF：:D eleteAccessPath 方法 (vds.h)

[从Windows 8和Windows Server 2012开始，虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]

从当前卷中删除访问路径。

语法

HRESULT DeleteAccessPath(
  [in] LPWSTR pwszPath,
  [in] BOOL   bForce
);

[in] pwszPath

包含要删除的访问路径的字符串。访问路径可以是驱动器号或 NTFS 卷上空目录的路径。如果是驱动器号，则必须包含尾随反斜杠，例如“F：”。如果它是目录的路径，则不需要尾随反斜杠，例如“C：\MyFolder\MyDocuments”。

[in] bForce

如果 为 TRUE，则访问路径将无条件删除，即使卷正在使用中也是如此。仅当访问路径为驱动器号时，此参数才有意义。

此方法可以返回标准 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及特定于 VDS 的返回值。它还可以使用 HRESULT_FROM_WIN32 宏返回转换的系统错误代码。错误可能源自 VDS 本身或正在使用的基础 VDS 提供程序。可能的返回值包括以下内容。

返回代码/值	说明
S_OK	该方法已成功完成。
VDS_E_OPERATION_DENIED 0x8004240AL	路径指向系统卷、启动卷、崩溃转储卷、休眠卷或页面文件卷。不能从这些卷中删除驱动器号。
VDS_E_PATH_NOT_FOUND 0x80042416L	找不到指定的路径。
VDS_E_DEVICE_IN_USE 0x80042413L	已成功删除访问路径，但出现错误。 VDS 可能无法更新分区的 GUID 分区表 (GPT) 属性，或者在删除驱动器号时未能删除默认网络共享 (（例如 F$) ）。
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	卷失败。
VDS_E_PACK_OFFLINE 0x80042444L	包含该卷的包不可访问。

如果卷上没有打开的句柄，则会立即删除驱动器号。但是，如果卷上有打开的句柄，则无法锁定卷并在计算机重启时删除驱动器号。