NetConfigurationAssignMultiString-Funktion (netconfiguration.h)

Die NetConfigurationAssignMultiString-Funktion weist einem angegebenen Wertnamen in der Registrierung einen Satz von Zeichenfolgen zu. Die Zeichenfolgen sind in einer angegebenen Auflistung von Frameworkzeichenfolgenobjekten enthalten.

Syntax

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

Parameter

[_In_] Configuration

Ein Handle für ein NETCONFIGURATION-Objekt, das einen geöffneten Registrierungsschlüssel darstellt.

[_In_] ValueName

Ein Zeiger auf eine UNICODE_STRING-Struktur , die einen Wertnamen enthält.

[_In_] Collection

Ein Handle für ein Frameworkauflistungsobjekt, das eine Auflistung von Frameworkzeichenfolgenobjekten darstellt.

Rückgabewert

Diese Funktion gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion möglicherweise einen entsprechenden NTSTATUS-Fehlercode zurück.

Hinweise

Der Clienttreiber ruft ein Handle für ein NETCONFIGURATION-Objekt ab, indem er NetConfigurationOpenConfiguration oder NetConfigurationOpenSubConfiguration aufruft.

Wenn unter dem geöffneten Registrierungsschlüssel bereits ein Eintrag mit demselben Namen wie ValueName vorhanden ist, ersetzt NetConfigurationAssignMultiString seinen aktuellen Wert durch den vom Aufrufer angegebenen Wert. Andernfalls fügt NetConfigurationAssignMultiString der Registrierung einen neuen Werteintrag mit dem angegebenen Namen und dem angegebenen Wert hinzu.

Anforderungen