WdfRegistryWdmGetHandle-Funktion (wdfregistry.h)

[Gilt für KMDF und UMDF]

Die WdfRegistryWdmGetHandle--Methode gibt ein Windows Driver Model (WDM)-Handle an den Registrierungsschlüssel zurück, den ein angegebenes Framework-Registrierungsschlüsselobjekt darstellt.

Syntax

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

Parameter

[in] Key

Ein Handle zu einem Registrierungsschlüsselobjekt, das einen geöffneten Registrierungsschlüssel darstellt.

Rückgabewert

WdfRegistryWdmGetHandle ein WDM-Handle an einen Registrierungsschlüssel zurückgibt.

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

Bemerkungen

Ein KMDF-Treiber kann den zurückgegebenen WDM-Handle an die ZwXxx-Routinen übergeben,, die ein WDM-Handle als Eingabe akzeptieren.

Ein UMDF-Treiber kann das zurückgegebene Handle an APIs übergeben, die einen HKEY erfordern, z. B. RegEnumKeyEx.

Das Handle, das vom WdfRegistryWdmGetHandle Methode zurückgegeben wird, ist gültig, bis das Registrierungsschlüsselobjekt gelöscht wird. Wenn der Treiber eine EvtCleanupCallback--Funktion für das Registrierungsschlüsselobjekt bereitstellt, ist der Zeiger gültig, bis die Rückruffunktion zurückgegeben wird.

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

Beispiele

Im folgenden Codebeispiel wird ein WDM-Handle für den Registrierungsschlüssel abgerufen, den ein angegebenes Framework-Registrierungsschlüsselobjekt darstellt.

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfregistry.h (include Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf)