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
要列舉值專案的登錄機碼控制碼。 成功呼叫 ZwCreateKey或ZwOpenKey會建立此控制碼。
[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。 |
備註
傳遞至ZwEnumerateValueKey的KeyHandle必須以KEY_QUERY_VALUE存取權開啟。 這可藉由將 KEY_QUERY_VALUE、KEY_READ 或 KEY_ALL_ACCESS 當做 DesiredAccess 參數傳遞至 ZwCreateKey 或 ZwOpenKey來完成。
Index只是一種在具有值專案之子機碼之間選取的方法。 對具有相同Index之ZwEnumerateValueKey的兩次呼叫不保證會傳回相同的結果。
如需使用登錄機碼的詳細資訊，請參閱 在驅動程式中使用登錄。
如果在使用者模式中呼叫此函式，您應該使用名稱 「NtEnumerateValueKey」 而不是 「ZwEnumerateValueKey」。
針對來自核心模式驅動程式的呼叫，Windows 原生系統服務常式的NtXxx和ZwXxx版本會以處理和解譯輸入參數的方式，以不同的方式運作。 如需常式 NtXxx和ZwXxx版本之間關聯性的詳細資訊，請參閱使用原生系統服務常式的 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) |