ZwEnumerateValueKey 函式 (wdm.h)

ZwEnumerateValueKey常式會取得開啟索引鍵之值專案的相關資訊。

語法

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

參數

[in] KeyHandle

要列舉值專案的登錄機碼控制碼。 成功呼叫 ZwCreateKeyZwOpenKey會建立此控制碼。

[in] Index

您想要值資訊之子機碼之以零起始的索引。

[in] KeyValueInformationClass

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

[out, optional] KeyValueInformation

接收所要求資訊的呼叫端配置緩衝區指標。

[in] Length

指定 KeyValueInformation 緩衝區的大小,以位元組為單位。

[out] ResultLength

接收值資訊大小之變數的指標,以位元組為單位。 如果這個常式傳回STATUS_SUCCESS,變數會指出傳回的資料量。 如果這個常式傳回STATUS_BUFFER_OVERFLOW或STATUS_BUFFER_TOO_SMALL,變數會指出保存值資訊所需的緩衝區大小。

傳回值

ZwEnumerateValueKey 會在成功時傳回STATUS_SUCCESS,或在失敗時傳回適當的錯誤碼。 可能的錯誤碼值包括:

傳回碼 描述
STATUS_BUFFER_OVERFLOW 提供的緩衝區太小,而且只有部分資料已寫入緩衝區。 *ResultLength 會設定為保存要求資訊所需的最小大小。
STATUS_BUFFER_TOO_SMALL 提供的緩衝區太小,而且沒有任何資料寫入緩衝區。 *ResultLength 會設定為保存要求資訊所需的最小大小。
STATUS_INVALID_PARAMETER KeyInformationClass參數不是有效的KEY_VALUE_INFORMATION_CLASS值。
STATUS_NO_MORE_ENTRIES Index值超出KeyHandle所指定登錄機碼的範圍。 例如,如果索引鍵有 n 個子機碼,則針對大於 n-1的任何值,常式會傳回STATUS_NO_MORE_ENTRIES。

備註

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

Index只是一種在具有值專案之子機碼之間選取的方法。 對具有相同IndexZwEnumerateValueKey的兩次呼叫不保證會傳回相同的結果。

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

如果在使用者模式中呼叫此函式,您應該使用名稱 「NtEnumerateValueKey」 而不是 「ZwEnumerateValueKey」。

針對來自核心模式驅動程式的呼叫,Windows 原生系統服務常式的NtXxxZwXxx版本會以處理和解譯輸入參數的方式,以不同的方式運作。 如需常式 NtXxxZwXxx版本之間關聯性的詳細資訊,請參閱使用原生系統服務常式的 Nt 和 Zw 版本

規格需求

   
目標平臺 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIS (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_PARTIAL_INFORMATION

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

ZwClose

ZwCreateKey

ZwOpenKey

ZwQueryValueKey