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，或在失敗時傳回適當的錯誤碼。 可能的錯誤碼值包括：
| 傳回碼 | Description |
|---|---|
| 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) |