CreateDirectoryFromAppW 函数 (fileapifromapp.h)

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

Syntax

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

参数

lpPathName

要创建的目录的路径。

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

lpSecurityAttributes

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

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

返回值

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

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

返回代码 Description
ERROR_ALREADY_EXISTS

指定的目录已存在。

ERROR_PATH_NOT_FOUND

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

要求

Requirement 价值
最低支持的客户端 Windows 10 版本 1803
Header fileapifromapp.h
Library OneCore.Lib