DeleteFileTransacted

原文链接 -> 传送门

函数功能：

【微软强烈建议开发者使用可替代的方法去实现你的应用的需求。很多情况下，TxF 的开发可以通过更简单并且更快捷的可用的技术实现。而且，TxF 在将来微软的 Windows 系统的版本中可能将不可用。更多信息，和替代 TxF，请参照 Alternatives to using Transactional NTFS。】

DeleteFileTransacted 函数用于删除一个现存文件（作为事务处理操作）。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL WINAPI DeleteFileTransacted(
  _In_ LPCTSTR lpFileName,
  _In_ HANDLE  hTransaction
);

参数解析：

返回值：

1. 如果函数运行成功，则返回值为非 0；

2. 如果函数运行失败，则返回值为 0。

想要调用更多的错误信息，请调用 GetLastError 函数。


备注：

1. 如果一个应用程序试图删除一个不存在的文件，那么 DeleteFileTransacted 函数将以带有 ERROR_FILE_NOT_FOUND 的方式运行失败。如果该文件是一个只读文件，那么该函数将以带有 ERROR_ACCESS_DENIED 的方式运行失败。

2. 下面的列表列出了删除、移除或关闭文件的一些技巧：

• 想要删除一个只读文件，首先你必须移除只读属性
• 想要删除或者重命名一个文件，您必须拥有删除该文件的权限，或在父目录中的删除子权限的任何一个
• 想要递归删除目录中的文件，可使用 SHFileOperation 函数
• 想要移除一个空目录，可使用 RemoveDirectoryTransacte 函数
• 想要关闭一个打开的文件，可以使用 CloseHandle 函数

3. 如果你建立了一个目录，该目录带有除了删除和删除子文件的全部访问权限，并且新文件的访问控制列表是继承于该目录，那么你能创建一个文件，并且不能够删除它。但是，你能够创建一个文件，并且获得你在创建一个新文件时返回给你的句柄上所需要全部访问权限。

4. 如果你在创建一个文件时需要删除权限，你能使用该句柄删除或者重命名该文件，但是不要使用任何其它的句柄。更多信息，请参照 File Security and Access Rights。

5. 如果一个应用试图删除一个为了正常的I/O有其它句柄打开或者是存储映像的文件DeleteFileTransacted函数会运行失败（当其它的句柄被打开时，FILE_SHARE_DELETE必须被指明）。

6. DeleteFileTransacted 函数标记一个在关闭时被删除的文件。如果事务依然活跃，当该文件的最后的事务处理书写器句柄被关闭时该文件被删除。如果一个文件有删除标记，并且一个事务处理书写器句柄在该事务完成之后依然打开，那么该文件不会被删除。

7. 符号链接：如果路径指向一个符号链接，则符号连接被删除，而不是目标被删除。想要删除目标，你必须调用 CreateFile 函数并且指定 FILE_FLAG_DELETE_ON_CLOSE。

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

SMB 3.0 不支持TxF。

需求：