다음을 통해 공유


REG_QUERY_VALUE_KEY_INFORMATION 구조체(wdm.h)

REG_QUERY_VALUE_KEY_INFORMATION 구조에는 쿼리 중인 레지스트리 키의 값 항목에 대한 정보가 포함됩니다.

통사론

typedef struct _REG_QUERY_VALUE_KEY_INFORMATION {
  PVOID                       Object;
  PUNICODE_STRING             ValueName;
  KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass;
  PVOID                       KeyValueInformation;
  ULONG                       Length;
  PULONG                      ResultLength;
  PVOID                       CallContext;
  PVOID                       ObjectContext;
  PVOID                       Reserved;
} REG_QUERY_VALUE_KEY_INFORMATION, *PREG_QUERY_VALUE_KEY_INFORMATION;

회원

Object

값 항목이 쿼리되는 키에 대한 레지스트리 키 개체에 대한 포인터입니다.

ValueName

정보를 검색할 값 항목의 이름을 포함하는 UNICODE_STRING 구조체에 대한 포인터입니다.

KeyValueInformationClass

시스템에서 반환할 정보 유형을 나타내는 KEY_VALUE_INFORMATION_CLASS 값입니다.

KeyValueInformation

시스템에서 반환할 정보를 포함하는 버퍼에 대한 포인터입니다. 버퍼의 형식은 KeyValueInformationClass값에 따라 달라집니다. 자세한 내용은 KEY_VALUE_INFORMATION_CLASS참조하세요.

Length

KeyValueInformation 버퍼의 크기(바이트)입니다.

ResultLength

KeyValueInformation 버퍼에서 유효한 데이터 양(바이트)을 수신하는 변수에 대한 포인터입니다.

CallContext

드라이버의 RegistryCallback 루틴에서 제공할 수 있는 선택적 드라이버 정의 컨텍스트 정보입니다. 이 멤버는 Windows Vista 이상 버전의 Windows 운영 체제에 대해 정의됩니다.

ObjectContext

CmSetCallbackObjectContext호출하여 드라이버가 레지스트리 개체와 연결한 드라이버 정의 컨텍스트 정보에 대한 포인터입니다. 이 멤버는 Windows Vista 이상 버전의 Windows 운영 체제에 대해 정의됩니다.

Reserved

이 멤버는 나중에 사용하도록 예약되어 있습니다. 이 멤버는 Windows Vista 이상 버전의 Windows 운영 체제에 대해 정의됩니다.

발언

시스템은 스레드가 키에 대한 값 항목을 쿼리하려고 할 때마다(예: 사용자 모드 스레드가 RegQueryValue 또는 regQueryValueEx 호출하거나 드라이버가 ZwDeleteKey호출할 때) RegistryCallback 루틴에 전달합니다.

레지스트리 필터링 작업에 대한 자세한 내용은 레지스트리 호출 필터링 참조하세요.

요구 사항

요구
지원되는 최소 클라이언트 Microsoft Windows XP 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)

참고 항목

CmSetCallbackObjectContext

RegistryCallback

ZwDeleteKey

ZwQueryValueKey