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 以降のオペレーティング システム バージョンで使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| ライブラリ | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 を する | HwStorPortProhibitedDIs、PowerIrpDDis |