다음을 통해 공유

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 반환합니다. 그렇지 않으면 메서드가 적절한 오류 코드를 반환합니다. 다음 표에서는 가능한 반환 상태 코드 중 일부를 보여 줍니다.

반환 코드 묘사
STATUS_INVALID_PARAMETER
 메서드에 전달된 QueryTable 매개 변수가 잘못되었음을 나타냅니다.
STATUS_OBJECT_NAME_NOT_FOUND
 메서드가 QueryTable 항목 중 하나에서 지정된 개체를 찾을 수 없음을 나타냅니다.

발언

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

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

요구 사항

요구 값
대상 플랫폼 보편적
헤더 portcls.h(Portcls.h 포함)
IRQL PASSIVE_LEVEL

참고 항목

IRegistryKey

RtlQueryRegistryValues