CreateDirectory 函数（winbase.h）

项目
11/20/2024

创建新目录。如果基础文件系统支持文件和目录的安全性，该函数会将指定的安全描述符应用于新目录。

若要指定模板目录，请使用 CreateDirectoryEx 函数。

若要将此操作作为事务处理操作执行，请使用 CreateDirectoryTransacted 函数。

语法

BOOL CreateDirectory(
  [in]           LPCTSTR               lpPathName,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

参数

[in] lpPathName

要创建的目录的路径。

对于此函数的 ANSI 版本，路径的默认字符串大小限制为 248 个字符（MAX_PATH - 足以容纳 8.3 文件名）。若要将此限制扩展到 32,767 宽字符，请调用函数的 Unicode 版本，并将“\？”追加到路径。有关详细信息，请参阅命名文件

提示从 Windows 10 版本 1607 开始，此函数的 unicode 版本（CreateDirectoryW），可以选择加入以删除 248 个字符限制，而无需追加“\\？\”。每个路径段的 255 个字符限制仍适用。有关详细信息，请参阅命名文件、路径和命名空间的“最大路径长度限制”部分。

[in, optional] lpSecurityAttributes

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

目标文件系统必须支持对文件和目录的安全性，才能使此参数生效。（当 GetVolumeInformation 返回 FS_PERSISTENT_ACLS时，会显示此情况。

返回值

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

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

返回代码	描述
ERROR_ALREADY_EXISTS	指定的目录已存在。
ERROR_PATH_NOT_FOUND	一个或多个中间目录不存在;此函数只会在路径中创建最终目录。

言论

某些文件系统（如 NTFS 文件系统）支持单个文件和目录的压缩或加密。在为此类文件系统格式化的卷上，新目录继承其父目录的压缩和加密属性。

应用程序可以通过使用 FILE_FLAG_BACKUP_SEMANTICS 标志集调用 CreateFile 来获取目录的句柄。有关代码示例，请参阅 CreateFile。

若要支持查询此对象的安全描述符的继承函数，可以启发式确定并报告继承是否有效。有关详细信息，请参阅可继承 ACE 的自动传播。

在 Windows 8 和 Windows Server 2012 中，以下技术支持此函数。

科技	支持
服务器消息块（SMB） 3.0 协议	是的
SMB 3.0 透明故障转移（TFO）	是的
具有横向扩展文件共享的 SMB 3.0 （SO）	是的
群集共享卷文件系统（CsvFS）	是的
可复原文件系统（ReFS）	是的

例子

有关示例，请参阅检索和更改文件属性。

要求

要求	价值
最低支持的客户端	Windows XP [桌面应用 \|UWP 应用]
支持的最低服务器	Windows Server 2003 [桌面应用 \|UWP 应用]
目标平台	窗户
标头	winbase.h （包括 Windows.h）
库	Kernel32.lib
DLL	Kernel32.dll