Функция 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 перечислены в файле заголовка Ntstatus.h, доступном в WDK, и описаны в документации по WDK.
Комментарии
У этой функции нет связанного файла заголовка. Вы также можете использовать функции LoadLibrary и GetProcAddress для динамической связи с Ntdll.dll.
Требования
| Целевая платформа | Windows |
| Header | winternl.h |
| Библиотека | ntdll.lib |
| DLL | ntdll.dll |