NtQueryInformationEnlistment 関数 (wdm.h)

ZwQueryInformationEnlistment ルーチンは、指定された参加オブジェクトに関する情報を取得します。

構文

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationEnlistment(
  [in]            HANDLE                       EnlistmentHandle,
  [in]            ENLISTMENT_INFORMATION_CLASS EnlistmentInformationClass,
  [out]           PVOID                        EnlistmentInformation,
  [in]            ULONG                        EnlistmentInformationLength,
  [out, optional] PULONG                       ReturnLength
);

パラメーター

[in] EnlistmentHandle

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

[in] EnlistmentInformationClass

取得 する情報を指定するENLISTMENT_INFORMATION_CLASS型指定された列挙値。 この値は、次のいずれかの値である必要があります。

  • EnlistmentBasicInformation
  • EnlistmentRecoveryInformation
列挙体の EnlistmentFullInformation 値は 、ZwQueryInformationEnlistment では使用されません。

[out] EnlistmentInformation

EnlistmentInformationClass パラメーターが指定する情報を受け取る、呼び出し元によって割り当てられたバッファーへのポインター。 EnlistmentInformationClass パラメーターの値が EnlistmentBasicInformation の場合、このバッファーの構造体型はENLISTMENT_BASIC_INFORMATIONする必要があります。 EnlistmentInformationClass パラメーターの値が EnlistmentRecoveryInformation の場合、このバッファーの型は、呼び出し元が ZwSetInformationEnlistment を呼び出したときに使用した呼び出し元定義型と一致する必要があります。

[in] EnlistmentInformationLength

EnlistmentInformation パラメーターが指すバッファーの長さ (バイト単位)。

[out, optional] ReturnLength

KTM が EnlistmentInformation バッファーに書き込む情報の長さをバイト単位で受け取る呼び出し元割り当て変数へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます

戻り値

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

リターン コード 説明
STATUS_OBJECT_TYPE_MISMATCH
指定されたハンドルは、参加オブジェクトへのハンドルではありません。
STATUS_INVALID_HANDLE
オブジェクト ハンドルが無効です。
STATUS_INVALID_INFO_CLASS
EnlistmentInformationClass パラメーターの値が無効です。
STATUS_INFO_LENGTH_MISMATCH
EnlistmentInformationLength パラメーターの値が無効です。
STATUS_ACCESS_DENIED
呼び出し元には、参加オブジェクトへの適切なアクセス権がありません。
 

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

注釈

リソース マネージャーは 、ZwSetInformationEnlistment を呼び出して、参加オブジェクトの参加リスト固有の回復情報を設定してから 、ZwQueryInformationEnlistment を呼び出して回復情報を取得できます。

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

ZwQueryInformationEnlistment の呼び出し元は、IRQL = PASSIVE_LEVELで実行されている必要があります。

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

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

要件

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

こちらもご覧ください

ENLISTMENT_BASIC_INFORMATION

ENLISTMENT_INFORMATION_CLASS

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

ZwCreateEnlistment

ZwOpenEnlistment

ZwSetInformationEnlistment