createDirectory 函数 (winbase.h)
新建目录。 如果基础文件系统支持对文件和目录的安全性,则 函数会将指定的安全描述符应用于新目录。
若要指定模板目录,请使用 CreateDirectoryEx 函数。
若要以事务处理操作的形式执行此操作,请使用 CreateDirectoryTransacted 函数。
语法
BOOL CreateDirectory(
[in] LPCTSTR lpPathName,
[in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes
);
参数
[in] lpPathName
要创建的目录的路径。
对于此函数的 ANSI 版本,路径的默认字符串大小限制为 248 个字符 (MAX_PATH - 有足够的空间容纳 8.3 文件名) 。 若要将此限制扩展到 32,767 个宽字符,请调用 函数的 Unicode 版本,并在路径前面添加“\?”。 有关详细信息,请参阅 命名文件
[in, optional] lpSecurityAttributes
指向 SECURITY_ATTRIBUTES 结构的指针。 结构的 lpSecurityDescriptor 成员指定新目录的安全描述符。 如果 lpSecurityAttributes 为 NULL,则目录将获取默认安全描述符。 目录的默认安全描述符中的 ACL 继承自其父目录。
目标文件系统必须支持文件和目录的安全性,此参数才能生效。 (当 GetVolumeInformation 返回 FS_PERSISTENT_ACLS.)
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。 可能的错误包括以下内容。
返回代码 | 说明 |
---|---|
|
指定的目录已存在。 |
|
一个或多个中间目录不存在;此函数只会在路径中创建最终目录。 |
注解
某些文件系统(如 NTFS 文件系统)支持对单个文件和目录进行压缩或加密。 在为此类文件系统格式化的卷上,新目录继承其父目录的压缩和加密属性。
应用程序可以通过调用设置了 FILE_FLAG_BACKUP_SEMANTICS 标志的 CreateFile 来获取目录的句柄。 有关代码示例,请参阅 CreateFile。
若要支持查询此对象的安全描述符的继承函数,可以启发式确定并报告继承是否有效。 有关详细信息 ,请参阅可继承 ACE 的自动传播 。
在 Windows 8 和 Windows Server 2012 中,此函数由以下技术支持。
技术 | 支持 |
---|---|
服务器消息块 (SMB) 3.0 协议 | 是 |
SMB 3.0 透明故障转移 (TFO) | 是 |
具有横向扩展文件共享的 SMB 3.0 (SO) | 是 |
群集共享卷文件系统 (CSV) | 是 |
弹性文件系统 (ReFS) | 是 |
示例
有关示例,请参阅 检索和更改文件属性。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | winbase.h (包括 Windows.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈