Funzione NetConfigurationAssignMultiString (netconfiguration.h)

La funzione NetConfigurationAssignMultiString assegna un set di stringhe a un nome di valore specificato nel Registro di sistema. Le stringhe sono contenute in una raccolta specificata di oggetti stringa del framework.

Sintassi

NTSTATUS NetConfigurationAssignMultiString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] WDFCOLLECTION    Collection
);

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

Handle per un oggetto insieme framework che rappresenta una raccolta di oggetti stringa del framework.

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, NetConfigurationAssignMultiString sostituisce il valore corrente con il valore fornito dal chiamante. In caso contrario, NetConfigurationAssignMultiString 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