TmRecoverEnlistment 関数 (wdm.h)

[アーティクル]
02/27/2024

TmRecoverEnlistment ルーチンは、指定された参加リストに関連付けられているトランザクションの回復操作を開始します。

構文

NTSTATUS TmRecoverEnlistment(
  [in] PKENLISTMENT Enlistment,
  [in] PVOID        EnlistmentKey
);

パラメーター

[in] Enlistment

参加リストオブジェクトへのポインター。コンポーネントは、 ResourceManagerNotification コールバックルーチンへの入力としてこのポインターを受け取ることができます。または、コンポーネントで ObReferenceObjectByHandle を呼び出し、前に ZwCreateEnlistment、 TmCreateEnlistment、または ZwOpenEnlistment を呼び出したオブジェクトハンドルを指定することもできます。

[in] EnlistmentKey

リソースマネージャーが ZwCreateEnlistment または TmCreateEnlistment への EnlistmentKey パラメーターとして以前に指定した参加キー値へのポインター。このパラメーターは省略可能で、リソースマネージャーが ZwCreateEnlistment または TmCreateEnlistment を呼び出したときに参加キーを指定しなかった場合は NULL にすることができます。

戻り値

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

リターンコード	説明
STATUS_OBJECT_TYPE_MISMATCH	指定されたハンドルは、参加オブジェクトへのハンドルではありません。
STATUS_INVALID_HANDLE	オブジェクトハンドルが無効です。
STATUS_TRANSACTION_REQUEST_NOT_VALID	トランザクションまたはその参加リストが正しい状態ではありません。
STATUS_PENDING	KTM は、コミット、ロールバック、または未確定通知をリソースマネージャーの通知キューに追加し、リソースマネージャーが ResourceManagerNotification コールバックルーチンを使用していません。

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

注釈

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

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

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

要件

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