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

Статья
02/07/2025

Извлекает указанное строковое значение из объекта конфигурации адаптера и назначает строку указанному объекту строки платформы.

Синтаксис

NTSTATUS NetConfigurationQueryString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringAttributes,
  [_Out_]    WDFSTRING             *WdfString
);

Параметры

[_In_] Configuration

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

[_In_] ValueName

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

[_In_opt_] StringAttributes

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

[_Out_] WdfString

Дескриптор объекта строки платформы. NetAdapterCx назначит строковые данные реестра этому объекту.

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

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

Замечания

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

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

Требования

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

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