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
[out] EnlistmentInformation
EnlistmentInformationClass パラメーターが指定する情報を受け取る、呼び出し元によって割り当てられたバッファーへのポインター。 EnlistmentInformationClass パラメーターの値が EnlistmentBasicInformation の場合、このバッファーの構造体型はENLISTMENT_BASIC_INFORMATIONする必要があります。 EnlistmentInformationClass パラメーターの値が EnlistmentRecoveryInformation の場合、このバッファーの型は、呼び出し元が ZwSetInformationEnlistment を呼び出したときに使用した呼び出し元定義型と一致する必要があります。
[in] EnlistmentInformationLength
EnlistmentInformation パラメーターが指すバッファーの長さ (バイト単位)。
[out, optional] ReturnLength
KTM が EnlistmentInformation バッファーに書き込む情報の長さをバイト単位で受け取る呼び出し元割り当て変数へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。
戻り値
操作が成功した場合、ZwQueryInformationEnlistment はSTATUS_SUCCESSを返します。 それ以外の場合、このルーチンは次のいずれかの値を返す可能性があります。
リターン コード | 説明 |
---|---|
|
指定されたハンドルは、参加オブジェクトへのハンドルではありません。 |
|
オブジェクト ハンドルが無効です。 |
|
EnlistmentInformationClass パラメーターの値が無効です。 |
|
EnlistmentInformationLength パラメーターの値が無効です。 |
|
呼び出し元には、参加オブジェクトへの適切なアクセス権がありません。 |
ルーチンは、他の NTSTATUS 値を返す場合があります。
注釈
リソース マネージャーは 、ZwSetInformationEnlistment を呼び出して、参加オブジェクトの参加リスト固有の回復情報を設定してから 、ZwQueryInformationEnlistment を呼び出して回復情報を取得できます。
ZwQueryInformationEnlistment の詳細については、「回復操作の処理」を参照してください。
ZwQueryInformationEnlistment の呼び出し元は、IRQL = PASSIVE_LEVELで実行されている必要があります。
NtQueryInformationEnlistment と ZwQueryInformationEnlistment は、同じ 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 |