ZwSinglePhaseReject 関数 (wdm.h)

  • [アーティクル]

ZwSinglePhaseReject ルーチンは、呼び出し元のリソース マネージャーが指定された参加リストに対する単一フェーズ コミット操作をサポートしないことを KTM に通知します。

構文

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

パラメーター

[in] EnlistmentHandle

ZwCreateEnlistment または ZwOpenEnlistment の以前の呼び出しによって取得された参加オブジェクトへのハンドル。 ハンドルには、 オブジェクトへのENLISTMENT_SUBORDINATE_RIGHTSアクセス権が必要です。

[in, optional] TmVirtualClock

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

戻り値

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

リターン コード 説明
STATUS_OBJECT_TYPE_MISMATCH
 指定されたハンドルは、参加オブジェクトへのハンドルではありません。
STATUS_INVALID_HANDLE
 オブジェクト ハンドルが無効です。
STATUS_TRANSACTION_NOT_REQUESTED
 トランザクションまたはその参加リストが正しい状態ではありません。
STATUS_ACCESS_DENIED
 呼び出し元は、参加オブジェクトに対する適切なアクセス権を持っていません。
 

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

注釈

リソース マネージャーは、TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT通知を受信したときに ZwSinglePhaseReject を呼び出すことができます。

ZwSinglePhaseReject の詳細については、「コミット操作の処理」を参照してください。

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

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

要件

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

こちらもご覧ください

TmSinglePhaseReject

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

ZwCreateEnlistment

ZwOpenEnlistment