IVdsVolumeMF：：AddAccessPath 方法 (vds.h)

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

添加访问路径。

语法

HRESULT AddAccessPath(
  [in] LPWSTR pwszPath
);

[in] pwszPath

指示访问路径的字符串，该路径是可用于打开卷的用户模式路径。访问路径可以是驱动器号或 NTFS 卷上空目录的路径。访问路径字符串必须包含尾随反斜杠，例如“F：”。

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

返回代码/值	说明
S_OK	已成功添加路径。
S_FALSE	已成功添加访问路径，但出现错误。在添加驱动器号时，VDS 可能无法更新分区的 GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER 属性，或者未能添加默认网络共享 (（例如 F$) ）。有关详细信息，请参阅 PARTITION_INFORMATION_GPT。
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	卷失败。
VDS_E_PACK_OFFLINE 0x80042444L	包含该卷的包不可访问。

VDS 通过创建装载的文件夹 (也称为卷装入点) 来添加访问路径。请注意，装载的文件夹仅在 NTFS 卷上受支持。有关详细信息，请参阅装载的文件夹。

如果 pwszPath 参数包含已装载文件夹的路径，即使目录为空 () 或 pwszPath 包含非空目录的路径，此方法也会返回ERROR_DIR_NOT_EMPTY。