WdfRegistryAssignUnicodeString-Funktion (wdfregistry.h)

Artikel
03/22/2025

[Gilt für KMDF und UMDF]

Die WdfRegistryAssignUnicodeString--Methode weist einer angegebenen Unicode-Zeichenfolge einen angegebenen Wertnamen in der Registrierung zu.

Syntax

NTSTATUS WdfRegistryAssignUnicodeString(
  [in] WDFKEY           Key,
  [in] PCUNICODE_STRING ValueName,
  [in] PCUNICODE_STRING Value
);

Die Parameter

[in] Key

Ein Handle zu einem Registrierungsschlüsselobjekt, 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 ValueName angibt.

Rückgabewert

WdfRegistryAssignUnicodeString gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Methode möglicherweise einen der folgenden Werte zurück:

Rückgabecode	BESCHREIBUNG
STATUS_INVALID_DEVICE_REQUEST	WdfRegistryAssignUnicodeString wurde bei IRQL = PASSIVE_LEVEL nicht aufgerufen.
STATUS_INVALID_PARAMETER	Es wurde ein ungültiger Parameter angegeben.
STATUS_ACCESS_DENIED	Der Treiber hat den Registrierungsschlüssel nicht mit KEY_SET_VALUE Zugriff geöffnet.
STATUS_INSUFFICIENT_RESOURCES	Zum Abschließen des Vorgangs war nicht genügend Arbeitsspeicher vorhanden.

Diese Methode kann auch andere NTSTATUS-Wertezurückgeben.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Wenn die Zeichenfolge, die der Value Parameter angibt, nicht NULL beendet ist, fügt das Framework beim Kopieren der Zeichenfolge in die Registrierung ein NULL-Zeichen hinzu.

Wenn der Wertname, den der parameter ValueName angibt, bereits vorhanden ist, aktualisiert WdfRegistryAssignUnicodeString die Daten des Werts.

Das Framework legt den Datentyp des Werts auf REG_SZ fest.

Weitere Informationen zu Registrierungsschlüsselobjekten finden Sie unter Verwenden der Registrierung in Framework-Based Drivers.

Beispiele

Im folgenden Codebeispiel wird der ValueName Wert unter einem angegebenen Registrierungsschlüssel eine Unicode-Zeichenfolge "String1" zugewiesen.

UNICODE_STRING ustring1, valueName;
NTSTATUS status;

RtlInitUnicodeString(
                     &ustring1,
                     L"String1"
                     );
RtlInitUnicodeString(
                     &valueName,
                     L"ValueName"
                     );

status = WdfRegistryAssignUnicodeString(
                                        Key,
                                        &valueName,
                                        &string1
                                        );

Anforderungen

Anforderung	Wert
Zielplattform	universell
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Kopfzeile	wdfregistry.h (include Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)