Funzione NetConfigurationAssignUnicodeString (netconfiguration.h)

  • Articolo

La funzione NetConfigurationAssignUnicodeString assegna una stringa Unicode specificata a un nome di valore specificato nel Registro di sistema.

Sintassi

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

Puntatore a una struttura UNICODE_STRING che contiene la stringa da assegnare 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, NetConfigurationAssignUnicodeString sostituisce il valore corrente con il valore fornito dal chiamante. In caso contrario, NetConfigurationAssignUnicodeString 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
Intestazione netconfiguration.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL