NtPrepareEnlistment 関数 (wdm.h)

ZwPrepareEnlistment ルーチンは、指定された参加リストのトランザクションの準備操作を開始します。

構文

__kernel_entry NTSYSCALLAPI NTSTATUS NtPrepareEnlistment(
  [in]           HANDLE         EnlistmentHandle,
  [in, optional] PLARGE_INTEGER TmVirtualClock
);

パラメーター

[in] EnlistmentHandle

ZwCreateEnlistment または ZwOpenEnlistment の前回の呼び出しによって取得された参加オブジェクトへのハンドル。 オブジェクトは 優れた参加リスト を表す必要があり、ハンドルはオブジェクトにENLISTMENT_SUPERIOR_RIGHTSアクセスできる必要があります。

[in, optional] TmVirtualClock

仮想クロック値へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。

戻り値

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

リターン コード 説明
STATUS_ENLISTMENT_NOT_SUPERIOR
呼び出し元は、参加リストの 優れたトランザクション マネージャー ではありません。
STATUS_TRANSACTION_RESPONSE_NOT_ENLISTED
呼び出し元は、TRANSACTION_NOTIFY_PREPARE_COMPLETE通知を受信するように登録しませんでした。
STATUS_OBJECT_TYPE_MISMATCH
指定されたハンドルは、参加オブジェクトへのハンドルではありません。
STATUS_INVALID_HANDLE
オブジェクト ハンドルが無効です。
STATUS_ACCESS_DENIED
呼び出し元には、参加オブジェクトへの適切なアクセス権がありません。
STATUS_TRANSACTION_REQUEST_NOT_VALID
参加リストのトランザクションが準備フェーズに入る状態ではありません。
 

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

注釈

ZwPrepareEnlistment を呼び出すことができるのは、上位のトランザクション マネージャーだけです。

ZwPrepareEnlistment ルーチンにより、KTM はトランザクションに参加しているすべてのリソース マネージャーにTRANSACTION_NOTIFY_PREPARE通知を送信します。

ZwPrepareEnlistment の呼び出し元は、TRANSACTION_NOTIFY_PREPARE_COMPLETE通知を受信するために登録する必要があります。

ZwPrepareEnlistment の詳細については、「優れたトランザクション マネージャーの作成コミット操作の処理」を参照してください。

NtPrePrepareEnlistmentZwPrePrepareEnlistment は、同じ Windows ネイティブ システム サービス ルーチンの 2 つのバージョンです。

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

要件

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

こちらもご覧ください

TmPrepareEnlistment

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

ZwCreateEnlistment

ZwOpenEnlistment