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

  • Статья

Извлекает запись реестра с значением MultiString, связанную с именем значения в указанном объекте конфигурации.

Синтаксис

NTSTATUS NetConfigurationQueryMultiString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringsAttributes,
  [_Inout_]  WDFCOLLECTION         Collection
);

Параметры

[_In_] Configuration

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

[_In_] ValueName

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

[_In_opt_] StringsAttributes

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

[_Inout_] Collection

Дескриптор объекта коллекции, предоставленного драйвером. Если функция выполнена успешно, содержит объект WDFSTRING для каждой строки, назначенной ValueName.

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

Функция возвращает STATUS_SUCCESS, если операция выполнена успешно. Если значение реестра равно NULL, NetConfigurationQueryMultiString возвращает STATUS_OBJECT_NAME_NOT_FOUND.

Комментарии

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

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

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1.21
Верхняя часть netconfiguration.h (включая netadaptercx.h)
Библиотека NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL