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

Статья
02/07/2025

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

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