REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION 구조체(wdm.h)
REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION 구조는 키에 대해 검색되는 여러 값 항목을 설명합니다.
통사론
typedef struct _REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION {
PVOID Object;
PKEY_VALUE_ENTRY ValueEntries;
ULONG EntryCount;
PVOID ValueBuffer;
PULONG BufferLength;
PULONG RequiredBufferLength;
PVOID CallContext;
PVOID ObjectContext;
PVOID Reserved;
} REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION, *PREG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION;
회원
Object
값 항목이 검색되는 키의 레지스트리 키 개체에 대한 포인터입니다.
ValueEntries
검색되는 각 값 항목에 대해 하나씩 KEY_VALUE_ENTRY 구조의 배열에 대한 포인터입니다.
EntryCount
ValueEntries 배열의 항목 수입니다.
ValueBuffer
ValueEntries 배열에서 지정한 모든 값 항목에 대한 데이터를 받는 버퍼에 대한 포인터입니다.
BufferLength
ValueBuffer 버퍼의 길이(바이트)를 포함하는 변수에 대한 포인터입니다.
RequiredBufferLength
ValueEntries 배열에서 지정하는 모든 값 항목에 대한 데이터를 보유하는 데 필요한 바이트 수를 시스템에서 받는 변수에 대한 포인터입니다. 이 멤버는 NULL 수 있습니다.
CallContext
드라이버의 RegistryCallback 루틴에서 제공할 수 있는 선택적 드라이버 정의 컨텍스트 정보입니다. 이 멤버는 Windows Vista 이상 버전의 Windows 운영 체제에 대해 정의됩니다.
ObjectContext
CmSetCallbackObjectContext호출하여 드라이버가 레지스트리 개체와 연결한 드라이버 정의 컨텍스트 정보에 대한 포인터입니다. 이 멤버는 Windows Vista 이상 버전의 Windows 운영 체제에 대해 정의됩니다.
Reserved
이 멤버는 나중에 사용하도록 예약되어 있습니다. 이 멤버는 Windows Vista 이상 버전의 Windows 운영 체제에 대해 정의됩니다.
발언
시스템은 스레드가 키에 대한 여러 값 항목을 한 번에 검색하려고 할 때마다(예: 사용자 모드 스레드가 regQueryMultipleValues 호출하는 경우) RegistryCallback 루틴에 이 구조를 전달합니다.
ValueEntries 배열의 각 KEY_VALUE_ENTRY 구조체는 ValueBuffer 버퍼의 값 항목 하나를 설명합니다. 특히 KEY_VALUE_ENTRYDataOffset 멤버에는 해당 값 항목의 데이터가 시작되는 ValueBuffer 내의 오프셋이 포함되며, DataLength 멤버에는 해당 값 항목에 대한 데이터의 길이(바이트)가 포함됩니다.
레지스트리 필터링 작업에 대한 자세한 내용은 레지스트리 호출 필터링 참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows XP 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |