ZwRollforwardTransactionManager 関数 (wdm.h)
ZwRollforwardTransactionManager ルーチンは、指定されたトランザクション マネージャーに割り当てられている進行中のすべてのトランザクションの回復操作を開始します。
構文
NTSYSCALLAPI NTSTATUS ZwRollforwardTransactionManager(
[in] HANDLE TransactionManagerHandle,
[in, optional] PLARGE_INTEGER TmVirtualClock
);
パラメーター
[in] TransactionManagerHandle
ZwCreateTransactionManager または ZwOpenTransactionManager の以前の呼び出しによって取得されたトランザクション マネージャー オブジェクトへのハンドル。 ハンドルには、 オブジェクトへのTRANSACTIONMANAGER_RECOVERアクセス権が必要です。
[in, optional] TmVirtualClock
仮想クロック値へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。 このパラメーターの詳細については、次の「解説」セクションを参照してください。
戻り値
操作が成功した場合、ZwRollforwardTransactionManager はSTATUS_SUCCESSを返します。 それ以外の場合、このルーチンは次のいずれかの値を返す可能性があります。
| リターン コード | 説明 |
|---|---|
|
指定されたハンドルは、トランザクション マネージャー オブジェクトへのハンドルではありません。 |
|
オブジェクト ハンドルが無効です。 |
|
呼び出し元には、トランザクション マネージャー オブジェクトへの適切なアクセス権がありません。 |
|
指定されたトランザクション マネージャー オブジェクトにはログ ファイルがないため、復旧は使用できません。 |
|
指定されたトランザクション マネージャー オブジェクトが予期しない状態です。 |
ルーチンは、他の NTSTATUS 値を返す場合があります。
注釈
ZwRollforwardTransactionManager ルーチンは、TMVirtualClock パラメーターが提供する仮想クロック値まで、KTM がトランザクション マネージャーのログ ファイルで検出したすべてのログアクティビティを復旧します。
コンポーネントは、 ZwRollforwardTransactionManager を繰り返し呼び出し、各呼び出しの前に VirtualClock パラメーターを高い値に設定することで、ログ ファイルを増分的に走査できます。
TmVirtualClock パラメーターが NULL の場合、ZwRollforwardTransactionManager の呼び出しは ZwRecoverTransactionManager の呼び出しと同じです。
回復操作の詳細については、「回復操作の 処理」を参照してください。
NtRollforwardTransactionManager と ZwRollforwardTransactionManager は、同じ Windows ネイティブ システム サービス ルーチンの 2 つのバージョンです。 Windows カーネルの NtRollforwardTransactionManager ルーチンは、カーネル モード ドライバーから直接アクセスできません。 ただし、カーネル モード ドライバーは、 ZwRollforwardTransactionManager ルーチンを呼び出すことによって間接的にこのルーチンにアクセスできます。
カーネル モード ドライバーからの呼び出しの場合、Windows ネイティブ システム サービス ルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なる場合があります。 ルーチンの NtXxx バージョンと ZwXxx バージョンの間の関係の詳細については、「ネイティブ システム サービス ルーチンの Nt バージョンと Zw バージョンの使用」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |