WdfRegistryRemoveKey-Funktion (wdfregistry.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die WdfRegistryRemoveKey--Methode entfernt den Registrierungsschlüssel, der einem angegebenen Framework-Registrierungsschlüsselobjekt zugeordnet ist, und löscht dann das Registrierungsschlüsselobjekt.

Syntax

NTSTATUS WdfRegistryRemoveKey(
  [in] WDFKEY Key
);

Parameter

[in] Key

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

Rückgabewert

WdfRegistryRemoveKey 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	WdfRegistryRemoveKey wurde bei IRQL = PASSIVE_LEVEL nicht aufgerufen.
STATUS_ACCESS_DENIED	Der Treiber hat den Registrierungsschlüssel nicht mit Löschzugriff geöffnet.
STATUS_NOT_IMPLEMENTED	Weitere Informationen finden Sie im Abschnitt "Hinweise".

Diese Methode kann auch andere NTSTATUS-Wertezurückgeben.

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

Bemerkungen

Anmerkung

Stellen Sie vor dem Aufrufen WdfRegistryRemoveKeysicher, dass alle Schlüssel und Werte unter dem angegebenen Schlüssel gelöscht wurden. Löschen Sie zuerst jeden Unterschlüssel, beginnend mit den Blatttasten, und arbeiten Sie nach oben.

Rufen Sie von einem KMDF-Treiber nicht WdfRegistryRemoveKey- auf, und WdfRegistryClose auf demselben Schlüssel. Der WDFKEY ist nicht mehr gültig, nachdem WdfRegistryRemoveKey zurückgegeben wurde.

Obwohl es für einen UMDF-Treiber zulässig ist, WdfRegistryRemoveKey-aufzurufen, gibt der Aufruf immer STATUS_NOT_IMPLEMENTEDzurück. Um das WDFKEY-Objekt zu löschen, sollte ein UMDF-Treiber stattdessen WdfRegistryCloseaufrufen.

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

Beispiele

Im folgenden Codebeispiel wird ein Registrierungsschlüssel entfernt und das Registrierungsschlüsselobjekt gelöscht.

NTSTATUS  status;

status = WdfRegistryRemoveKey(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), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Freigeben über