IRegistryKey::QueryRegistryValues 메서드(portcls.h)

메서드 QueryRegistryValues 를 사용하면 호출자가 단일 호출을 사용하여 레지스트리의 여러 값을 쿼리할 수 있습니다.

구문

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

매개 변수

[in] QueryTable

하나 이상의 RTL_QUERY_REGISTRY_TABLE 구조체 배열에 대한 포인터입니다. (이 구조체는 RtlQueryRegistryValues에 설명되어 있습니다.) 각 구조체는 호출자가 쿼리하는 레지스트리 항목의 값 이름 및 하위 키 이름을 지정합니다. 각 구조에는 메서드가 해당 레지스트리 항목에 대한 정보를 사용하여 호출하는 호출자 제공 QueryRoutine 콜백 QueryRegistryValues 에 대한 함수 포인터도 포함됩니다. 배열은 NULL인 Name 멤버가 있는 구조체에 의해 종료되어야 합니다.

[in, optional] Context

호출자 정의 컨텍스트 값입니다. 메서드는 QueryRegistryValues 이 값을 각 QueryRoutine 콜백에 대한 호출 매개 변수로 전달합니다. 컨텍스트 값은 일반적으로 호출자의 QueryRoutine 이 액세스하는 컨텍스트 데이터를 포함하는 호출자 정의 구조체에 대한 포인터입니다. 컨텍스트 값은 포인터 형식 PVOID로 캐스팅되지만 메서드는 QueryRegistryValues 포인터의 유효성 검사를 수행하지 않습니다.

반환 값

QueryRegistryValues 는 호출이 전체 QueryTable을 처리하는 데 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 메서드는 적절한 오류 코드를 반환합니다. 다음 표에서는 가능한 반환 상태 코드 중 일부를 보여 줍니다.

설명

이 메서드는 호출자 제공 콜백 루틴을 사용하여 레지스트리 항목 목록의 값을 열거합니다. 성공하면 메서드는 목록의 모든 콜백 루틴을 호출한 후 를 반환합니다.

QueryTable 매개 변수는 RTL_QUERY_REGISTRY_TABLE 구조체의 배열을 가리킵니다. 이 구조체의 첫 번째 멤버인 QueryRoutine은 호출자가 제공한 콜백 루틴에 대한 함수 포인터입니다. 자세한 내용은 RtlQueryRegistryValues를 참조하세요.

요구 사항

추가 정보

IRegistryKey

RtlQueryRegistryValues