FindFirstFileNameTransactedW 函数 (winbase.h)
[Microsoft 强烈建议开发人员使用替代方法来实现应用程序的需求。 TxF 致力于实现的许多方案都可以通过更简单、更易用的技术来实现。 此外，TxF 在 Microsoft Windows 的将来版本中可能不可用。 有关详细信息，以及 TxF 的替代方法，请参阅事务性 NTFS 的替代方法。]
以事务处理操作的形式创建指向指定文件的所有硬链接的枚举。 该函数返回枚举的句柄，该句柄可用于 FindNextFileNameW 函数的后续调用。
语法
HANDLE FindFirstFileNameTransactedW(
[in] LPCWSTR lpFileName,
[in] DWORD dwFlags,
[in, out] LPDWORD StringLength,
[in, out] PWSTR LinkName,
[in, optional] HANDLE hTransaction
);
参数
[in] lpFileName
文件的名称。
文件必须驻留在本地计算机上;否则，函数将失败，最后一个错误代码设置为 ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE ( 6805) 。
[in] dwFlags
保留;指定零 (0) 。
[in, out] StringLength
LinkName 参数指向的缓冲区的大小（以字符为单位）。 如果此调用失败，并且错误 ERROR_MORE_DATA (234) ，则此参数返回的值是 LinkName 指向的缓冲区必须包含所有数据的大小。
[in, out] LinkName
指向缓冲区的指针，用于存储为 lpFileName 找到的第一个链接名称。
[in, optional] hTransaction
事务的句柄。 此句柄由 CreateTransaction 函数返回。
返回值
如果函数成功，则返回值是可与 FindNextFileNameW 函数一起使用或使用 FindClose 函数关闭的搜索句柄。
如果函数失败，则返回值 INVALID_HANDLE_VALUE (0xffffffff) 。 功能
获取扩展错误信息，调用 GetLastError 函数。
注解
在 Windows 8 和 Windows Server 2012 中，此函数由以下技术支持。
| 技术 | 支持 |
|---|---|
| 服务器消息块 (SMB) 3.0 协议 | 否 |
| SMB 3.0 透明故障转移 (TFO) | 否 |
| 具有横向扩展文件共享的 SMB 3.0 (SO) | 否 |
| 群集共享卷文件系统 (CSV) | 否 |
| 弹性文件系统 (ReFS) | 否 |
SMB 3.0 不支持 TxF。
要求
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | winbase.h (包括 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |