CreateDirectoryTransactedA 函数 (winbase.h)

[Microsoft强烈建议开发人员利用替代方法来实现应用程序的需求。 TxF 开发的许多方案可以通过更简单、更易用的技术来实现。 此外,TxF 在 Microsoft Windows 的未来版本中可能不可用。 有关详细信息,以及 TxF 的替代项,请参阅 使用事务 NTFS的替代项。]

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

语法

BOOL CreateDirectoryTransactedA(
  [in, optional] LPCSTR                lpTemplateDirectory,
  [in]           LPCSTR                lpNewDirectory,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [in]           HANDLE                hTransaction
);

参数

[in, optional] lpTemplateDirectory

创建新目录时用作模板的目录的路径。 此参数可以 NULL

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

提示

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

目录必须驻留在本地计算机上;否则,函数将失败,最后一个错误代码设置为 ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE

[in] lpNewDirectory

要创建的目录的路径。

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

提示

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

[in, optional] lpSecurityAttributes

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

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

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

[in] hTransaction

事务的句柄。 此句柄由 CreateTransaction 函数返回。

返回值

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

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

返回代码 描述
ERROR_ALREADY_EXISTS
指定的目录已存在。
ERROR_EFS_NOT_ALLOWED_IN_TRANSACTION
不能创建具有禁用加密的父目录的子目录。
ERROR_PATH_NOT_FOUND
一个或多个中间目录不存在。 此函数仅在路径中创建最终目录。

言论

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

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

如果尝试创建具有禁用加密的父目录的子目录,则此函数将失败并 ERROR_EFS_NOT_ALLOWED_IN_TRANSACTION

可以使用 FILE_FLAG_BACKUP_SEMANTICS 标志集调用 CreateFileTransacted 函数来获取目录的句柄。

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

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

SMB 3.0 不支持 TxF。

注意

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

要求

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

另请参阅

CreateFileTransacted

创建和删除目录

目录管理功能

RemoveDirectoryTransacted

SECURITY_ATTRIBUTES

事务性 NTFS