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

  • Статья

Функция NetConfigurationAssignBinary записывает двоичные данные, предоставленные вызывающим объектом, в указанное имя значения в реестре.

Синтаксис

NTSTATUS NetConfigurationAssignBinary(
  [_In_]                             NETCONFIGURATION Configuration,
  [_In_]                             PCUNICODE_STRING ValueName,
  [__In_reads_bytes_(BufferLength)_] void             *Buffer,
  [_In_]                             ULONG            BufferLength
);

Параметры

[_In_] Configuration

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

[_In_] ValueName

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

[__In_reads_bytes_(BufferLength)_] Buffer

Указатель на буфер, содержащий данные, предоставленные драйвером.

[_In_] BufferLength

Длина (в байтах) буфера, на который указывает буфер .

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

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

Комментарии

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

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

Требования

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