ZwQueryValueKey routine

ZwQueryValueKey routine

ZwQueryValueKey 返回一个注册表键的值。

Syntax

NTSTATUS ZwQueryValueKey(
_In_      HANDLE                      KeyHandle,
_In_      PUNICODE_STRING             ValueName,
_In_      KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass,
_Out_opt_ PVOID                       KeyValueInformation,
_In_      ULONG                       Length,
_Out_     PULONG                      ResultLength
);

Parameters

KeyHandle [in]

注册表键句柄，希望从这个键获取值。由 ZwCreateKey 或ZwOpenKey创建了这个句柄。

ValueName [in]

指向（意图从这个子键获取值的）子键（value entry）的名字

KeyValueInformationClass [in]

一个 KEY_VALUE_INFORMATION_CLASS 值，该值决定了返回到KeyValueInformation缓冲区 的数据的信息类型。

KeyValueInformation [out, optional]

指向用户自己申请的内存缓冲区，用于接收请求的结果。

Length [in]

以字节为单位的size，指定KeyValueInformation 缓冲区的长度。

ResultLength [out]

指向接收返回大小的变量的一个指针。大小以字节为单位。如果 ZwQueryValueKey 返回STATUS_SUCCESS, 调用者可以使用这个变量的值，用于确定返回了多少数据。如果返回了STATUS_BUFFER_OVERFLOW or STATUS_BUFFER_TOO_SMALL, 调用者可以使用这个值用来确定需要多少字节能存放返回值（key的信息）；

Return value

ZwQueryValueKey 成功返回STATUS_SUCCESS ，失败返回一个合适的错误码，可能的错误码包括：

Return code	Description
STATUS_OBJECT_NAME_NOT_FOUND	注册表值不可用。
STATUS_BUFFER_OVERFLOW	提供的缓冲区过小仅有部分数据写入到缓冲区中。 并写入需要的最小值到*ResultLength。
STATUS_BUFFER_TOO_SMALL	缓冲区过小且无数据写入到缓冲区。*ResultLength 被设置为需要的最小值。
STATUS_INVALID_PARAMETER	KeyInformationClass 不是有效的 KEY_VALUE_INFORMATION_CLASS 值 Warning 如果指定KeyValueInformationClass为 KeyValueBasicInformation ， Windows 98 and Windows Me 返回 STATUS_SUCCESS 即使是键或者值不存在。

Remarks

传给 ZwQueryValueKey 的KeyHandle必须已经以KEY_QUERY_VALUE访问打开. 可以使用 KEY_QUERY_VALUE, KEY_READ, or KEY_ALL_ACCESS 作为 DesiredAccess 参数调用函数 ZwCreateKey or ZwOpenKey.

更多操作注册表键的信息见Using the Registry in a Driver.

Note 如调用发生在用户模式，您应当使用"NtQueryValueKey" 代替"ZwQueryValueKey".

Requirements

Target platform	Universal
Version	Available starting with Windows 2000.
Header	Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI compliance rules	IrqlZwPassive, PowerIrpDDis, ZwRegistryCreate, ZwRegistryOpen, HwStorPortProhibitedDDIs,ZwRegistryCreate(storport), ZwRegistryOpen(storport)

See also

KEY_VALUE_BASIC_INFORMATION

KEY_VALUE_FULL_INFORMATION

KEY_VALUE_INFORMATION_CLASS

KEY_VALUE_PARTIAL_INFORMATION

ZwCreateKey

ZwEnumerateValueKey

ZwOpenKey