共用方式為

IRegistryKey：：QueryRegistryValues 方法 (portcls.h)

  • 發行項

方法 QueryRegistryValues 可讓呼叫端使用單一呼叫從登錄查詢數個值。

語法

NTSTATUS QueryRegistryValues(
  [in]           PRTL_QUERY_REGISTRY_TABLE QueryTable,
  [in, optional] PVOID                     Context
);

參數

[in] QueryTable

一或多個RTL_QUERY_REGISTRY_TABLE結構的數位指標。 (此結構會在 RtlQueryRegistryValues.) Each 結構中指定呼叫端正在查詢之登錄專案的值名稱和子機碼名稱。 每個結構也都包含呼叫端所提供 QueryRoutine 回呼的函式指標， QueryRegistryValues 該方法會使用對應登錄專案的相關信息來呼叫。 陣列必須由 名稱 成員為 NULL的結構終止。

[in, optional] Context

這是呼叫端定義的內容值。 方法會將 QueryRegistryValues 此值當做呼叫參數傳遞至每個 QueryRoutine 回呼。 內容值通常是呼叫端定義結構的指標，其中包含呼叫端 QueryRoutine 存取的內容數據。 內容值會轉換成指標類型 PVOID，但 QueryRegistryValues 方法不會執行指標的驗證。

傳回值

QueryRegistryValues 如果呼叫成功處理整個 QueryTable，則會傳回STATUS_SUCCESS。 否則，方法會傳回適當的錯誤碼。 下表顯示一些可能的傳回狀態代碼。

傳回碼 Description
STATUS_INVALID_PARAMETER
 表示傳遞至方法的 QueryTable 參數無效。
STATUS_OBJECT_NAME_NOT_FOUND
 表示方法找不到其中一個 QueryTable 專案中指定的物件。

備註

這個方法會使用呼叫端提供的回呼例程來列舉登錄專案清單的值。 如果成功，方法會在呼叫清單中的所有回呼例程之後傳回。

QueryTable 參數會指向RTL_QUERY_REGISTRY_TABLE結構的陣列。 這個結構的第一個成員 QueryRoutine 是呼叫端所提供回呼例程的函式指標。 如需詳細資訊，請參閱 RtlQueryRegistryValues。

規格需求

需求 值
目標平台 Universal
標頭 portcls.h (包含 Portcls.h)
IRQL PASSIVE_LEVEL

另請參閱

IRegistryKey

RtlQueryRegistryValues