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

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

  • Статья

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

Синтаксис

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 (включая netadaptercx.h)
IRQL PASSIVE_LEVEL