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) |