注意
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 が返されます。 ログのアクティブな範囲に関する情報を使用して、アーカイブするログの量に関する決定を導くことができます。
Refs： このコードはサポートされていません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| Header | winioctl.h (Windows.h を含む) |