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


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

Функция NetConfigurationAssignUnicodeString назначает указанную строку Юникода указанному имени значения в реестре.

Синтаксис

NTSTATUS NetConfigurationAssignUnicodeString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] PCUNICODE_STRING Value
);

Параметры

[_In_] Configuration

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

[_In_] ValueName

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

[_In_] Value

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

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

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

Замечания

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

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

Требования

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