FSCTL_TXFS_QUERY_RM_INFORMATION IOCTL (winioctl.h)
注意
Microsoft 強烈建議開發人員利用替代方法來達成應用程式的需求。 許多針對 TxF 開發的案例,都可以透過更簡單且更容易取得的技術來達成。 此外,未來版本的 Microsoft Windows 可能無法使用 TxF。 如需詳細資訊,以及 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) |