CreateDirectoryFromAppW 函数 (fileapifromapp.h)
新建目录。 此函数的行为与 CreateDirectory 相同,只不过此函数遵循通用 Windows 平台应用安全模型。
语法
WINSTORAGEAPI BOOL CreateDirectoryFromAppW(
LPCWSTR lpPathName,
LPSECURITY_ATTRIBUTES lpSecurityAttributes
) noexcept;
参数
lpPathName
要创建的目录的路径。
有关在不附加“\?\?\”的情况下选择退出 MAX_PATH 限制的信息,请参阅 命名文件、路径和命名空间 的“最大路径长度限制”部分了解详细信息。
lpSecurityAttributes
指向 SECURITY_ATTRIBUTES 结构的指针。 结构的 lpSecurityDescriptor 成员指定新目录的安全描述符。 如果 lpSecurityAttributes 为 NULL,则目录将获取默认安全描述符。 目录的默认安全描述符中的 ACL 继承自其父目录。
目标文件系统必须支持文件和目录的安全性,此参数才能生效。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。 可能的错误包括以下内容。
返回代码 | 说明 |
---|---|
ERROR_ALREADY_EXISTS | 指定的目录已存在。 |
ERROR_PATH_NOT_FOUND | 一个或多个中间目录不存在;此函数只会在路径中创建最终目录。 |
要求
最低受支持的客户端 | Windows 10 版本 1803 |
标头 | fileapifromapp.h |