FSCTL_TXFS_QUERY_RM_INFORMATION IOCTL (winioctl.h)

注意

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

检索资源管理器 (RM) 的信息。

若要执行此操作,请使用以下参数调用 DeviceIoControl 函数。

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to device
  FSCTL_TXFS_QUERY_RM_INFORMATION,  // dwIoControlCode
  NULL,                             // lpInBuffer
  0,                                // nInBufferSize
  (LPVOID) lpOutBuffer,             // output buffer
  (DWORD) nOutBufferSize,           // size of output buffer
  (LPDWORD) lpBytesReturned,        // bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

注解

FSCTL_TXFS_QUERY_RM_INFORMATION 是同步操作。

如果此调用失败并出现ERROR_BUFFER_TOO_SMALL则 TXFS_QUERY_RM_INFORMATION 结构的 BytesRequired 成员将指定缓冲区的大小才能成功返回调用。

如果要编写支持远程服务器消息块协议客户端的应用程序,则必须使用此控制代码才能使用资源管理器。

无论其状态如何,都可以查询资源管理器;如果未启动 RM,则返回 ERROR_RM_NOT_ACTIVE 。 可以使用有关日志活动范围的信息来指导决定要存档的日志量。

裁判: 不支持此代码。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 winioctl.h (包括 Windows.h)

另请参阅