Функция 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 |