Función NetConfigurationAssignUlong (netconfiguration.h)

La función NetConfigurationAssignUlong escribe un valor de palabra larga sin signo proporcionado por el autor de la llamada en un nombre de valor especificado en el Registro.

Sintaxis

NTSTATUS NetConfigurationAssignUlong(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] ULONG            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

Valor ULONG que se 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.

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