Función NetConfigurationAssignBinary (netconfiguration.h)

La función NetConfigurationAssignBinary escribe datos binarios proporcionados por el llamador en un nombre de valor especificado en el Registro.

Sintaxis

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

Parámetros

[_In_] Configuration

Identificador de un objeto NETCONFIGURATION que representa una clave del Registro abierta.

[_In_] ValueName

Puntero a una estructura UNICODE_STRING que contiene un nombre de valor.

[__In_reads_bytes_(BufferLength)_] Buffer

Puntero a un búfer que contiene datos proporcionados por el controlador.

[_In_] BufferLength

Longitud, en bytes, del búfer al que puntos del búfer.

Valor devuelto

Esta función devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta función puede devolver un código de error NTSTATUS adecuado.

Observaciones

El controlador cliente obtiene un identificador para un objeto NETCONFIGURATION llamando a NetAdapterOpenConfiguration o NetConfigurationOpenSubConfiguration.

Si ya existe una entrada del mismo nombre que ValueName en la clave del Registro abierta, NetConfigurationAssignBinary reemplaza su valor actual por el valor proporcionado por el autor de la llamada. De lo contrario, NetConfigurationAssignBinary agrega una nueva entrada de valor con el nombre especificado y el valor proporcionado al Registro.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
versión mínima de KMDF	1.21
versión mínima de UMDF	2.33
encabezado de	netconfiguration.h (include netadaptercx.h)
irQL	PASSIVE_LEVEL