TmRecoverTransactionManager 関数 (wdm.h)

  • [アーティクル]

TmRecoverTransactionManager ルーチンは、ログ ストリーム内にある回復情報からトランザクション マネージャー オブジェクト (すべてのトランザクション、参加リスト、リソース マネージャーを含む) の状態を再構築します。

構文

NTSTATUS TmRecoverTransactionManager(
  [in] PKTM           Tm,
  [in] PLARGE_INTEGER TargetVirtualClock
);

パラメーター

[in] Tm

トランザクション マネージャー オブジェクトへのポインター。 このポインターを取得するには、TPS コンポーネント ObReferenceObjectByHandle を呼び出し、ZwCreateTransactionManager または ZwOpenTransactionManager に対する前回の呼び出し 指定 オブジェクト ハンドルを指定する必要があります。

[in] TargetVirtualClock

仮想クロック値へのポインター。 このパラメーターは省略可能であり、NULLできます。 このパラメーターの詳細については、次の「解説」セクションを参照してください。 Windows Vista の場合、このパラメーターは NULLする必要があります。

戻り値

TmRecoverTransactionManager 、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、このルーチンは次のいずれかの値を返す可能性があります。

リターン コード 形容
STATUS_NOT_IMPLEMENTED
 Windows Vista の場合、呼び出し元は、TargetVirtualClock パラメーターに以外の NULL 値を指定しました。
STATUS_TM_VOLATILE
 指定されたトランザクション マネージャー オブジェクトにはログ ファイルがないため、復旧は使用できません。
STATUS_UNSUCCESSFUL
 指定されたトランザクション マネージャー オブジェクトが予期しない状態です。
 

ルーチンは、他 NTSTATUS 値を返す場合があります。

備考

TmRecoverTransactionManager ルーチンは、ZwRecoverTransactionManager ルーチンのポインター ベースのバージョンです。

TargetVirtualClock パラメーター値 NULL を使用して TmRecoverTransactionManager を呼び出すことは、ZwRecoverTransactionManager呼び出すことと機能的に同等です。 TargetVirtualClock パラメーター値 非NULLで TmRecoverTransactionManager を呼び出すことは、機能的には ZwRollforwardTransactionManager呼び出すことと同じです。

回復操作の詳細については、「回復操作の処理 」を参照してください。

ZwXxx ルーチンの代わりに KTM の TmXxx ルーチン 使用する場合の詳細については、「TmXxx ルーチンの使用 を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista 以降のオペレーティング システム バージョンで使用できます。
ターゲット プラットフォーム の 万国
ヘッダー wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

関連項目

ZwRecoverTransactionManager

ZwRollforwardTransactionManager