Share via

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)

另请参阅