CreateDirectoryFromAppW 函数 (fileapifromapp.h)

新建目录。 此函数的行为与 CreateDirectory 相同,只不过此函数遵循通用 Windows 平台应用安全模型。

语法

WINSTORAGEAPI BOOL CreateDirectoryFromAppW(
  LPCWSTR               lpPathName,
  LPSECURITY_ATTRIBUTES lpSecurityAttributes
) noexcept;

参数

lpPathName

要创建的目录的路径。

有关在不附加“\?\?\”的情况下选择退出 MAX_PATH 限制的信息,请参阅 命名文件、路径和命名空间 的“最大路径长度限制”部分了解详细信息。

lpSecurityAttributes

指向 SECURITY_ATTRIBUTES 结构的指针。 结构的 lpSecurityDescriptor 成员指定新目录的安全描述符。 如果 lpSecurityAttributesNULL,则目录将获取默认安全描述符。 目录的默认安全描述符中的 ACL 继承自其父目录。

目标文件系统必须支持文件和目录的安全性,此参数才能生效。

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。 可能的错误包括以下内容。

返回代码 说明
ERROR_ALREADY_EXISTS

指定的目录已存在。

ERROR_PATH_NOT_FOUND

一个或多个中间目录不存在;此函数只会在路径中创建最终目录。

要求

   
最低受支持的客户端 Windows 10 版本 1803
标头 fileapifromapp.h