Fonction WdfRegistryRemoveKey (wdfregistry.h)

Article
02/29/2024

[S’applique à KMDF et UMDF]

La méthode WdfRegistryRemoveKey supprime la clé de Registre associée à un objet de clé de registre d’infrastructure spécifié, puis supprime l’objet de clé de registre.

Syntaxe

NTSTATUS WdfRegistryRemoveKey(
  [in] WDFKEY Key
);

Paramètres

[in] Key

Handle d’un objet de clé de Registre qui représente une clé de Registre ouverte.

Valeur retournée

WdfRegistryRemoveKey retourne STATUS_SUCCESS si l’opération réussit. Sinon, la méthode peut retourner l’une des valeurs suivantes :

Code de retour	Description
STATUS_INVALID_DEVICE_REQUEST	WdfRegistryRemoveKey n’a pas été appelé à IRQL = PASSIVE_LEVEL.
STATUS_ACCESS_DENIED	Le pilote n’a pas ouvert la clé de Registre avec un accès de suppression.
STATUS_NOT_IMPLEMENTED	Consultez la section Notes.

Cette méthode peut également retourner d’autres valeurs NTSTATUS.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Notes

Avant d’appeler WdfRegistryRemoveKey, vérifiez que toutes les clés et valeurs sous la clé donnée ont été supprimées. Supprimez d’abord chaque sous-clé, en commençant par les touches feuilles et faites votre chemin vers le haut.

Remarque

À partir d’un pilote KMDF, n’appelez pas WdfRegistryRemoveKey , puis WdfRegistryClose sur la même clé. WDFKEY n’est plus valide après le retour de WdfRegistryRemoveKey .

Bien qu’il soit légal pour un pilote UMDF d’appeler WdfRegistryRemoveKey, l’appel retourne toujours STATUS_NOT_IMPLEMENTED. Pour supprimer l’objet WDFKEY, un pilote UMDF doit à la place appeler WdfRegistryClose.

Pour plus d’informations sur les objets de clé de Registre, consultez Utilisation du Registre dans les pilotes Framework-Based.

Exemples

L’exemple de code suivant supprime une clé de Registre et supprime l’objet de clé de Registre.

NTSTATUS  status;

status = WdfRegistryRemoveKey(Key);

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
Version UMDF minimale	2.0
En-tête	wdfregistry.h (include Wdf.h)
Bibliothèque	Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Partager via