CreateDirectoryEx
注：本文档由 谁动了我的豆包 翻译，小甲鱼校对。原文链接 -> 传送门
函数功能：
CreateDirectoryEx 函数用于创建一个新目录，该目录带有一个指定的模板目录的属性。如果底层的文件系统支持文件和目录的安全性，那么该函数就将指定的安全描述符应用到新目录。该新目录保留指定的模板目录的其它属性。
调用 CreateDirectoryTransacted 函数，将这个操作作为一个事务处理操作来执行。
API 函数原型：
注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选的。
BOOL WINAPI CreateDirectoryEx(
_In_ LPCTSTR lpTemplateDirectory,
_In_ LPCTSTR lpNewDirectory,
_In_opt_ LPSECURITY_ATTRIBUTES lpSecurityAttributes
);
参数解析：
参数 含义
lpTemplateDirectory1. 当创建一个新目录时，该参数用于指定被用作一个模板目录的路径
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”部分。
lpNewDirectory1. 该参数用于指定要被创建的目录的路径
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”部分。
lpSecurityAttributes1. 该参数表示一个指向 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
HeaderWinBase.h (包含于 Windows.h)
LibraryKernel32.lib
DLLKernel32.dll
Unicode and ANSI namesCreateDirectoryExW (Unicode) 和 CreateDirectoryExA (ANSI)
【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。
页:
[1]