NtRollforwardTransactionManager 関数 (wdm.h)

  • [アーティクル]

ZwRollforwardTransactionManager ルーチンは、指定されたトランザクション マネージャーに割り当てられている進行中のすべてのトランザクションの回復操作を開始します。

構文

__kernel_entry NTSYSCALLAPI NTSTATUS NtRollforwardTransactionManager(
  [in]           HANDLE         TransactionManagerHandle,
  [in, optional] PLARGE_INTEGER TmVirtualClock
);

パラメーター

[in] TransactionManagerHandle

ZwCreateTransactionManager または ZwOpenTransactionManager の以前の呼び出しによって取得されたトランザクション マネージャー オブジェクトへのハンドル。 ハンドルには、 オブジェクトへのTRANSACTIONMANAGER_RECOVERアクセス権が必要です。

[in, optional] TmVirtualClock

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

戻り値

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

リターン コード 説明
STATUS_OBJECT_TYPE_MISMATCH
 指定されたハンドルは、トランザクション マネージャー オブジェクトへのハンドルではありません。
STATUS_INVALID_HANDLE
 オブジェクト ハンドルが無効です。
STATUS_ACCESS_DENIED
 呼び出し元には、トランザクション マネージャー オブジェクトへの適切なアクセス権がありません。
STATUS_TM_VOLATILE
 指定されたトランザクション マネージャー オブジェクトにはログ ファイルがないため、復旧は使用できません。
STATUS_UNSUCCESSFUL
 指定されたトランザクション マネージャー オブジェクトが予期しない状態です。
 

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

注釈

ZwRollforwardTransactionManager ルーチンは、TMVirtualClock パラメーターによって提供される仮想クロック値まで、KTM がトランザクション マネージャーのログ ファイルで検出したすべてのログアクティビティを復旧します。

コンポーネントは、 ZwRollforwardTransactionManager を繰り返し呼び出し、各呼び出しの前に VirtualClock パラメーターを高い値に設定することで、ログ ファイルを段階的に走査できます。

TmVirtualClock パラメーターが NULL の場合、ZwRollforwardTransactionManager の呼び出しは ZwRecoverTransactionManager の呼び出しと同じです。

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

NtRollforwardTransactionManager と ZwRollforwardTransactionManager は、同じ Windows ネイティブ システム サービス ルーチンの 2 つのバージョンです。 Windows カーネルの NtRollforwardTransactionManager ルーチンは、カーネル モード ドライバーから直接アクセスできません。 ただし、カーネル モード ドライバーは、 ZwRollforwardTransactionManager ルーチンを呼び出すことによって、このルーチンに間接的にアクセスできます。

カーネル モード ドライバーからの呼び出しの場合、Windows ネイティブ システム サービス ルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なります。 ルーチンの NtXxx バージョンと ZwXxx バージョン間の関係の詳細については、「Using Nt and Zw Versions of the Native System Services Routines」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista 以降のバージョンの Windows で使用できます。
対象プラットフォーム ユニバーサル
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 HwStorPortProhibitedDIs、PowerIrpDDis

こちらもご覧ください

TmRecoverTransactionManager

Nt および Zw バージョンのネイティブ システム サービス ルーチンの使用

ZwCreateTransactionManager

ZwOpenTransactionManager

ZwRecoverTransactionManager