CreateDirectoryExA 函数（winbase.h）

项目
11/20/2024

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

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

语法

BOOL CreateDirectoryExA(
  [in]           LPCSTR                lpTemplateDirectory,
  [in]           LPCSTR                lpNewDirectory,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

参数

[in] lpTemplateDirectory

默认情况下，名称限制为MAX_PATH个字符。若要将此限制扩展到 32,767 宽字符，请将“\\？\”前面追加到路径。有关详细信息，请参阅命名文件、路径和命名空间。

提示

从 Windows 10 版本 1607 开始，你可以选择加入以删除MAX_PATH限制，而无需追加“\\？\”。有关详细信息，请参阅命名文件、路径和命名空间的“最大路径长度限制”部分。

[in] lpNewDirectory

要创建的目录的路径。

提示

[in, optional] lpSecurityAttributes

指向 SECURITY_ATTRIBUTES 结构的指针。 lpSecurityDescriptor 结构的成员为新目录指定安全描述符。

如果 lpSecurityAttributesNULL，则目录将获取默认的安全描述符。目录的默认安全描述符中的访问控制列表（ACL）继承自其父目录。

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

返回值

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

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

返回代码	描述
ERROR_ALREADY_EXISTS	指定的目录已存在。
ERROR_PATH_NOT_FOUND	一个或多个中间目录不存在。此函数仅在路径中创建最终目录。若要在路径上创建所有中间目录，请使用 SHCreateDirectoryEx 函数。

言论

CreateDirectoryEx 函数允许创建从其他目录继承流信息的目录。例如，使用 Macintosh 目录时，此函数非常有用，该目录具有正确标识目录内容作为属性所需的资源流。

某些文件系统（如 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）	是的

注意

winbase.h 标头将 CreateDirectoryEx 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

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