Compartir a través de

Función NetConfigurationAssignBinary (netconfiguration.h)

  • Artículo

La función NetConfigurationAssignBinary escribe datos binarios proporcionados por el autor de la llamada 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 apunta el 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.

Comentarios

El controlador cliente obtiene un identificador para un objeto NETCONFIGURATION mediante una llamada 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 Value
Plataforma de destino Universal
Versión mínima de KMDF 1.21
Versión mínima de UMDF 2,33
Encabezado netconfiguration.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL