NtQueryMultipleValueKey 함수(winternl.h)
[이 함수는 추가 공지 없이 Windows에서 변경되거나 제거될 수 있습니다.]
지정된 다중 값 키에 대한 값을 검색합니다.
구문
__kernel_entry NTSTATUS NtQueryMultipleValueKey(
[in] HANDLE KeyHandle,
[in, out] PKEY_VALUE_ENTRY ValueEntries,
[in] ULONG EntryCount,
[out] PVOID ValueBuffer,
[in, out] PULONG BufferLength,
[out, optional] PULONG RequiredBufferLength
);
매개 변수
[in] KeyHandle
값을 검색할 키에 대한 핸들입니다. 핸들은 KEY_QUERY_VALUE 액세스 권한으로 열어야 합니다.
[in, out] ValueEntries
검색할 값의 이름을 포함하는 [KEY_VALUE_ENTRY] 구조체의 배열에 대한 포인터입니다.
[in] EntryCount
ValueEntries 배열의 요소 수입니다.
[out] ValueBuffer
값을 받을 버퍼에 대한 포인터입니다.
[in, out] BufferLength
ValueBuffer의 버퍼 크기를 바이트 단위로 포함하는 변수에 대한 포인터입니다. 함수가 반환되면 BufferLength 매개 변수에는 ValueBuffer에서 버퍼에 기록된 바이트 수가 포함됩니다.
[out, optional] RequiredBufferLength
함수에서 반환하는 모든 값에 필요한 바이트 수를 수신하는 변수에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.
반환 값
NTSTATUS 또는 오류 코드를 반환합니다.
버퍼가 너무 작아서 검색할 정보를 보유하지 못하면 함수는 STATUS_BUFFER_OVERFLOW 반환하고 RequiredBufferLength 매개 변수가 지정된 경우 필요한 버퍼 크기로 설정합니다.
NTSTATUS 오류 코드의 양식과 중요성은 WDK에서 사용할 수 있는 Ntstatus.h 헤더 파일에 나열되며 WDK 설명서에 설명되어 있습니다.
설명
이 함수에는 연결된 헤더 파일이 없습니다. LoadLibrary 및 GetProcAddress 함수를 사용하여 Ntdll.dll 동적으로 연결할 수도 있습니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | winternl.h |
| 라이브러리 | ntdll.lib |
| DLL | ntdll.dll |