ZwQueryValueKey 函式 (wdm.h)

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

要從中讀取值專案的索引鍵控制碼。 此控制碼是由成功呼叫 ZwCreateKeyZwOpenKey所建立。

[in] ValueName

要取得資料之值專案名稱的指標。

[in] KeyValueInformationClass

KEY_VALUE_INFORMATION_CLASS值,決定KeyValueInformation緩衝區中傳回的資訊類型。

[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值。
警告如果您指定KeyValueBasicInformationClass 的 KeyValueBasicInformation,即使登錄機碼或值名稱不存在,Windows 98 和 Windows Me 仍會傳回STATUS_SUCCESS。
 

備註

傳遞至ZwQueryValueKeyKeyHandle必須以KEY_QUERY_VALUE存取權開啟。 這可藉由將KEY_QUERY_VALUE、KEY_READ或KEY_ALL_ACCESS當做 DesiredAccess 參數傳遞至 ZwCreateKeyZwOpenKey來完成。

如需使用登錄機碼的詳細資訊,請參閱 在驅動程式中使用登錄

注意 如果呼叫此函式發生在使用者模式中,您應該使用名稱 「NtQueryValueKey」 而不是 「ZwQueryValueKey」。
 
對於核心模式驅動程式的呼叫,Windows 原生系統服務常式的NtXxxZwXxx版本在處理和解譯輸入參數的方式可能會有不同的行為。 如需常式NtXxxZwXxx版本之間的關聯性詳細資訊,請參閱使用 Nt 和 Zw 版本的原生系統服務常式

必要條件

   
最低支援的用戶端 從 Windows 2000 開始提供。
目標平臺 環球
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 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)

另請參閱

KEY_VALUE_BASIC_INFORMATION

KEY_VALUE_FULL_INFORMATION

KEY_VALUE_INFORMATION_CLASS

KEY_VALUE_PARTIAL_INFORMATION

使用原生系統服務常式的 Nt 和 Zw 版本

ZwCreateKey

ZwEnumerateValueKey

ZwOpenKey