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

Статья
02/07/2025

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

Синтаксис

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
минимальная версия UMDF	2.33
заголовка	netconfiguration.h (include netadaptercx.h)
библиотеки	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

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