MSFT_Partition 类的 AddAccessPath 方法

将装载路径或驱动器号分配添加到分区。

语法

UInt32 AddAccessPath(
  [in]  String  AccessPath,
  [in]  Boolean AssignDriveLetter,
  [out] String  ExtendedStatus
);

参数

AccessPath [in]

指定访问路径,该路径是可用于打开分区的用户模式路径。 访问路径可以是驱动器号(例如“C:”或“C:\”)或指向 NTFS 卷上的一个空目录的路径。 访问路径字符串不需要尾部反斜杠。

AssignDriveLetter [in]

如果 为 TRUE,则会将下一个可用驱动器号分配给分区。

ExtendedStatus [out]

包含嵌入 MSFT_StorageExtendedStatus 对象的字符串。

此参数允许存储提供程序返回特定于实现的扩展 () 错误信息。

返回值

成功 (0)

不支持 (1)

未指定的错误 (2)

超时 (3)

失败 (4)

参数 (5) 无效

拒绝访问 (40001)

没有足够的资源来完成操作。 (40002)

请求的访问路径已在使用中。 (42002)

无法为隐藏分区分配访问路径。 (42004)

访问路径无效。 (42007)

注解

此方法将装载路径或驱动器号分配添加到分区。 AccessPathAssignDriveLetter 参数互斥,如果同时指定两个参数,将导致参数无效错误。 此方法通过创建装载文件夹 (也称为卷装入点) 来添加访问路径。 请注意,装载的文件夹仅在 NTFS 格式的分区上受支持。 如果 AccessPath 中指定的路径是已在使用 (即使目录为空) 或包含非空目录的路径,此方法也会返回错误。

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
命名空间 Root\Microsoft\Windows\Storage
标头 Vds.h
MOF Storagewmi.mof

另请参阅

MSFT_Partition