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


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

Функция NetConfigurationAssignMultiString назначает набор строк указанному имени значения в реестре. Строки содержатся в указанной коллекции строковых объектов платформы.

Синтаксис

NTSTATUS NetConfigurationAssignMultiString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] WDFCOLLECTION    Collection
);

Параметры

[_In_] Configuration

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

[_In_] ValueName

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

[_In_] Collection

Дескриптор объекта коллекции платформы, который представляет коллекцию строковых объектов платформы.

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

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

Комментарии

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

Если в открытом разделе реестра уже существует запись с тем же именем, что и ValueName, NetConfigurationAssignMultiString заменяет текущее значение значением, предоставленным вызывающим объектом. В противном случае NetConfigurationAssignMultiString добавляет в реестр новую запись значения с заданным именем и предоставленным значением.

Требования

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