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

추가 정보

레지스트리 키 보안 및 액세스 권한