Funzione NetConfigurationAssignUlong (netconfiguration.h)

La funzione netConfigurationAssignUlong scrive un valore long senza segno fornito dal chiamante in un nome di valore specificato nel Registro di sistema.

Sintassi

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

Parametri

[_In_] Configuration

Handle di un oggetto NETCONFIGURATION che rappresenta una chiave del Registro di sistema aperta.

[_In_] ValueName

Puntatore a una struttura UNICODE_STRING che contiene un nome di valore.

[_In_] Value

Valore ULONG che verrà assegnato al nome del valore specificato ValueName.

Valore restituito

Questa funzione restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa funzione può restituire un codice di errore NTSTATUS appropriato.

Osservazioni

Il driver client ottiene un handle per un oggetto NETCONFIGURATION chiamando NetAdapterOpenConfiguration o NetConfigurationOpenSubConfiguration.

Se esiste già una voce con lo stesso nome di ValueName nella chiave del Registro di sistema aperta, NetConfigurationAssignUlong sostituisce il valore corrente con il valore fornito dal chiamante. In caso contrario, NetConfigurationAssignUlong aggiunge una nuova voce di valore con il nome specificato e il valore fornito al Registro di sistema.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.21
versione minima di UMDF	2.33
intestazione	netconfiguration.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL