Funzione NetConfigurationAssignMultiString (netconfiguration.h)

  • Articolo

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 per un oggetto NETCONFIGURATION che rappresenta una chiave del Registro di sistema aperta.

[_In_] ValueName

Puntatore a una struttura UNICODE_STRING contenente 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.

Commenti

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

Se una voce dello stesso nome di ValueName esiste già 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 specificato valore 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