Funzione NetConfigurationAssignUlong (netconfiguration.h)

Articolo
05/23/2024

La funzione NetConfigurationAssignUlong scrive un valore di parola 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 per 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 di valore specificato da 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.

Commenti

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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.21
Versione UMDF minima	2.33
Intestazione	netconfiguration.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Condividi tramite