FSCTL_TXFS_GET_TRANSACTED_VERSION IOCTL (winioctl.h)
注意
Microsoft 强烈建议开发人员利用替代方法来实现应用程序的需求。 TxF 致力于实现的许多方案都可以通过更简单、更易用的技术来实现。 此外,TxF 在 Microsoft Windows 的将来版本中可能不可用。 有关详细信息以及 TxF 的替代方法,请参阅 使用事务 NTFS 的替代方法。
返回一个 TXFS_GET_TRANSACTED_VERSION 结构。 该结构标识指定文件的最新提交版本,即句柄的版本号。
若要执行此操作,请使用以下参数调用 DeviceIoControl 函数。
BOOL DeviceIoControl(
(HANDLE) hDevice, // handle to device
FSCTL_TXFS_GET_TRANSACTED_VERSION, // dwIoControlCode
NULL, // lpInBuffer
0, // nInBufferSize
(LPVOID) lpOutBuffer, // output buffer
(DWORD) nOutBufferSize, // size of output buffer
(LPDWORD) lpBytesReturned, // number of bytes returned
NULL // OVERLAPPED structure
);
注解
FSCTL_TXFS_GET_TRANSACTED_VERSION 是同步操作。
此控制代码可用于跟踪最新版本的基本文件。 对于指定的句柄,基版本始终是打开句柄时返回的基值,但最新版本会根据其他事务所做的任何提交操作而更改。 如果句柄随后关闭并再次打开,则基本版本和最新版本将更新为新值,并且来自其他事务的任何后续提交操作都会更改最新版本。
如果尝试检索资源管理器根目录的版本,则会返回 值 TXFS_TRANSACTED_VERSION_NONTRANSACTED 。
裁判: 不支持此代码。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
标头 | winioctl.h (包括 Windows.h) |