Функция NetConfigurationQueryBinary (netconfiguration.h)

Статья
02/07/2025

Извлекает данные, назначенные в данный момент указанному значению реестра, сохраняет данные в выделенном платформой буфере и создает объект памяти платформы для представления буфера.

Синтаксис

NTSTATUS NetConfigurationQueryBinary(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_]     POOL_TYPE             PoolType,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
  [_Out_]    WDFMEMORY             *Memory
);

Параметры

[_In_] Configuration

Дескриптор объекта NETCONFIGURATION, представляющий открытый раздел реестра.

[_In_] ValueName

Указатель на структуру UNICODE_STRING, содержащую имя значения.

[_In_] PoolType

Значение POOL_TYPEтипа, указывающее тип памяти, выделяемый для буфера данных.

[_In_opt_] MemoryAttributes

Указатель на структуру WDF_OBJECT_ATTRIBUTES, содержащую атрибуты объекта для нового объекта памяти. Этот параметр является необязательным и может быть WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Memory

Указатель на расположение, которое получает дескриптор к новому объекту памяти. Платформа выделяет этот буфер памяти и автоматически освобождает его при закрытии объекта NETCONFIGURATION.

Возвращаемое значение

Функция возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта функция может вернуть соответствующий код ошибки NTSTATUS.

Замечания

Драйвер клиента получает дескриптор для объекта NETCONFIGURATION путем вызова NetAdapterOpenConfiguration или NetConfigurationOpenSubConfiguration.

Память, выделенная этой функцией, автоматически освобождается платформой при закрытии объекта NETCONFIGURATION.

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.21
минимальная версия UMDF	2.33
заголовка	netconfiguration.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Поделиться через