NetConfigurationAssignUnicodeString-Funktion (netconfiguration.h)

Die NetConfigurationAssignUnicodeString-Funktion weist eine angegebene Unicode-Zeichenfolge einem angegebenen Wertnamen in der Registrierung zu.

Syntax

NTSTATUS NetConfigurationAssignUnicodeString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] PCUNICODE_STRING Value
);

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

Ein Zeiger auf eine UNICODE_STRING-Struktur , die die Zeichenfolge enthält, die dem Wertnamen zugewiesen werden soll, der von ValueName angegeben wird.

Rückgabewert

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

Hinweise

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

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

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.21
UMDF-Mindestversion	2.33
Kopfzeile	netconfiguration.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL