Compartir a través de

Función NetConfigurationAssignUnicodeString (netconfiguration.h)

  • Artículo

La función NetConfigurationAssignUnicodeString asigna una cadena Unicode especificada a un nombre de valor especificado en el Registro.

Sintaxis

NTSTATUS NetConfigurationAssignUnicodeString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] PCUNICODE_STRING Value
);

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

Puntero a una estructura de UNICODE_STRING que contiene la cadena que se va a asignar al nombre de valor que ValueName especifica.

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, NetConfigurationAssignUnicodeString reemplaza su valor actual por el valor proporcionado por el autor de la llamada. De lo contrario, NetConfigurationAssignUnicodeString 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