Función NetConfigurationAssignMultiString (netconfiguration.h)

La función NetConfigurationAssignMultiString asigna un conjunto de cadenas a un nombre de valor especificado en el Registro. Las cadenas están contenidas en una colección especificada de objetos de cadena de marco.

Sintaxis

NTSTATUS NetConfigurationAssignMultiString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] WDFCOLLECTION    Collection
);

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_] Collection

Identificador de un objeto de colección de marcos que representa una colección de objetos de cadena de marco.

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, NetConfigurationAssignMultiString reemplaza su valor actual por el valor proporcionado por el autor de la llamada. De lo contrario, NetConfigurationAssignMultiString 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
Encabezado	netconfiguration.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL