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 が返されます。 ログのアクティブな範囲に関する情報を使用して、アーカイブするログの量に関する決定を導くことができます。

Refs： このコードはサポートされていません。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header winioctl.h (Windows.h を含む)

こちらもご覧ください