CreateDirectoryEx

小甲鱼

注：本文档由 谁动了我的豆包 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

CreateDirectoryEx 函数用于创建一个新目录，该目录带有一个指定的模板目录的属性。如果底层的文件系统支持文件和目录的安全性，那么该函数就将指定的安全描述符应用到新目录。该新目录保留指定的模板目录的其它属性。

调用 CreateDirectoryTransacted 函数，将这个操作作为一个事务处理操作来执行。


API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选的。

1. BOOL WINAPI CreateDirectoryEx(
   
2.   _In_     LPCTSTR               lpTemplateDirectory,
   
3.   _In_     LPCTSTR               lpNewDirectory,
   
4.   _In_opt_ LPSECURITY_ATTRIBUTES lpSecurityAttributes
   
5. );

复制代码

参数解析：

参数	含义
lpTemplateDirectory	1. 当创建一个新目录时，该参数用于指定被用作一个模板目录的路径 2. 在该函数的 ANSI 版本中，目录的名字被限制在 MAX_PATH 个字符。想要将该限制扩大到 32767 个字符宽度，可调用该函数的 Unicode 版本并且要预先考虑到路径中的“\\?\”。更多信息，请参照 Naming a File 3. 要点：从 Windows10 的 1607 版本开始，对于该函数的 Unicode 版本（CreateDirectoryExW）你可以考虑是否去取消 MAX_PATH 字符的限制并且不用预先考 虑“\\?\”。 每个路径段 255 个字符的限制仍然适用。详细细节可以参照 Naming Files,Path,and Namingspaced 的”Maximum Path Length Limitation”部分。
lpNewDirectory	1. 该参数用于指定要被创建的目录的路径 2. 在该函数的 ANSI 版本中，目录的名字被限制在 MAX_PATH 个字符。想要将该限制扩大到 32767 个字符宽度，可调用该函数的 Unicode 版本并且要预先考虑到路径中的“\\?\”。更多信息，请参照 Naming a File 3. 要点：从 Windows10 的 1607 版本开始，对于该函数的 Unicode 版本（CreateDirectoryExW）你可以考虑是否去取消 MAX_PATH 字符的限制并且不用预先考 虑“\\?\”。 每个路径段 255 个字符的限制仍然适用。详细细节可以参照 Naming Files,Path,and Namingspaced 的”Maximum Path Length Limitation”部分。
lpSecurityAttributes	1. 该参数表示一个指向 SECURITY_ATTRIBUTES 结构的指针。该结构中的 lpSecurityDescriptor 成员为新目录指定了一个安全描述符。如果 IpSecurityAttributes 成员为 NULL，那么该目录将得到一个默认的安全描述符。对于一个目录，在默认安全描述符中的访问控制列表（ACL）继承于它的父目录 2. 为了让该参数有一个结果，目标文件系统必须支持文件和目录的安全性（当 GetVolumeInformation 函数返回 PS_PERSISTENT_ACLS 时，该结果被指定）

返回值：

1. 如果该函数运行成功，返回值为非 0；
               
2. 如果该函数运行失败，返回值为 0。

想要得到更多的错误信息，请调用 GetLastError 函数。
               
可能的错误包括以下几个：

返回的代码	描述
ERROR_ALREADY_EXISTS	该标识表明指定的目录已经存在
ERROR_PATH_NOT_FOUND	该标识表明一个或更多的中间目录为不存在；该函数将只会创建路径中的最终目录。想要创建路径中的全部中间目录，可以调用 SHCreateDiredtoryEx 函数

备注：

1. CreateDirectoryEx 函数允许你去创建继承来自其它目录的流信息的目录。例如，当你正使用 Macintosh 的目录，其中有一个资源流被需要用来正确识别目录的内容作为一个属性时，该函数是有用的。

2. 像 NTFS 文件系统一样，一些文件系统支持对单个文件和目录的压缩或加密。对于这样的一个文件系统，在卷的格式化上，一个新的目录继承它的父目录的压缩和加密属性。

3. 一个应用能够通过调用带有 FILE_FLAG_BACKUP_SEMANTICS 标识集的 CreateFile 函数，获得一个目录句柄，代码示例，请参照 CreateFile 函数。

4. 支持查询该对象的安全描述符的继承功能，可以试探性地确定和报告继承是有效的。更多信息，请参照 Automatic Propagation of Inheritable ACEs。

5. 在 Windows 8 和 Windows Server 2012 中，该函数由以下技术支持：

技术	是否被支持
Server Message Block (SMB) 3.0 protocol	是
SMB 3.0 Transparent Failover (TFO)	是
SMB 3.0 with Scale-out File Shares (SO)	是
Cluster Shared Volume File System (CsvFS)	是
Resilient File System (ReFS)	是

SMB 3.0 不支持TxF。


需求：

Minimum supported client	Windows XP [桌面应用程序 | Windows 商店应用程序]
Minimum supported server	Windows 2003 服务器版 [桌面应用程序 | Windows 商店应用程序]
Minimum supported phone	Windows Phone 8
Header	WinBase.h (包含于 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll
Unicode and ANSI names	CreateDirectoryExW (Unicode) 和 CreateDirectoryExA (ANSI)

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。