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

  • Статья

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

Синтаксис

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
Верхняя часть netconfiguration.h (включая netadaptercx.h)
IRQL PASSIVE_LEVEL