ZwQueryValueKey 関数 (wdm.h)

[アーティクル]
02/27/2024

ZwQueryValueKey ルーチンは、レジストリキーの値エントリを返します。

構文

NTSYSAPI NTSTATUS ZwQueryValueKey(
  [in]            HANDLE                      KeyHandle,
  [in]            PUNICODE_STRING             ValueName,
  [in]            KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass,
  [out, optional] PVOID                       KeyValueInformation,
  [in]            ULONG                       Length,
  [out]           PULONG                      ResultLength
);

パラメーター

[in] KeyHandle

値エントリの読み取り元のキーを処理します。このハンドルは、 ZwCreateKey または ZwOpenKey の正常な呼び出しによって作成されます。

[in] ValueName

データを取得する値エントリの名前へのポインター。

[in] KeyValueInformationClass

KeyValueInformation バッファーで返される情報の種類を決定するKEY_VALUE_INFORMATION_CLASS値。

[out, optional] KeyValueInformation

要求された情報を受信する呼び出し元によって割り当てられたバッファーへのポインター。

[in] Length

KeyValueInformation バッファーのサイズをバイト単位で指定します。

[out] ResultLength

キー情報のサイズ (バイト単位) を受け取る変数へのポインター。 ZwQueryValueKey ルーチンがSTATUS_SUCCESSを返す場合、呼び出し元はこの変数の値を使用して、返されるデータの量を決定できます。ルーチンがSTATUS_BUFFER_OVERFLOWまたはSTATUS_BUFFER_TOO_SMALLを返す場合、呼び出し元はこの変数の値を使用して、キー情報を保持するために必要なバッファーのサイズを決定できます。

戻り値

ZwQueryValueKey は 、成功した場合はSTATUS_SUCCESS、失敗した場合は適切なエラーコードを返します。考えられるエラーコードの値は次のとおりです。

リターンコード	説明
STATUS_OBJECT_NAME_NOT_FOUND	レジストリ値が使用できませんでした。
STATUS_BUFFER_OVERFLOW	指定されたバッファーが小さすぎて、部分的なデータのみがバッファーに書き込まれた。 ResultLength は、要求された情報を保持するために必要な最小サイズに設定されます。
STATUS_BUFFER_TOO_SMALL	指定されたバッファーが小さすぎて、バッファーにデータが書き込まれなかった。 ResultLength は、要求された情報を保持するために必要な最小サイズに設定されます。
STATUS_INVALID_PARAMETER	KeyInformationClass パラメーターが有効なKEY_VALUE_INFORMATION_CLASS値ではありません。

注釈

ZwQueryValueKey に渡される KeyHandle は、KEY_QUERY_VALUEアクセス権で開かれている必要があります。これを行うには、 DesiredAccess パラメーターとして KEY_QUERY_VALUE、KEY_READ、または KEY_ALL_ACCESSを ZwCreateKey または ZwOpenKey に渡します。

レジストリキーの操作の詳細については、「ドライバーでのレジストリの使用」を参照してください。

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

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport)、 IrqlZwPassive(wdm)、 PowerIrpDDis(wdm)、 ZwRegistryCreate(storport)、ZwRegistryCreate(storport)、 ZwRegistryCreate(wdm)、 ZwRegistryOpen(storport)、ZwRegistryOpen(storport)、 ZwRegistryOpen(wdm)