Partager via


Fonction ZwDeleteKey (wdm.h)

La routine ZwDeleteKey supprime une clé ouverte du Registre.

Syntaxe

NTSYSAPI NTSTATUS ZwDeleteKey(
  [in] HANDLE KeyHandle
);

Paramètres

[in] KeyHandle

Gérez la clé de Registre à supprimer. Le handle est créé par un appel réussi à ZwCreateKey ou ZwOpenKey.

Valeur retournée

ZwDeleteKey retourne une valeur NTSTATUS. Les valeurs de retour possibles sont les suivantes :

  • STATUS_SUCCESS

  • STATUS_ACCESS_DENIED

  • STATUS_INVALID_HANDLE

  • STATUS_CANNOT_DELETE (voir Remarques)

Remarques

Avant d’appeler ZwDeleteKey, 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.

Le handle doit avoir été ouvert pour l’accès DELETE pour que cette routine réussisse. Pour plus d’informations, consultez le paramètre DesiredAccess pour ZwCreateKey.

Un appel à ZwDeleteKey rend non valide le handle spécifié dans le paramètre KeyHandle et tous les autres handles de la clé supprimée. Une fois qu’un appel à ZwDeleteKey invalide les poignées de clé, vous devez appeler ZwClose pour fermer les poignées de clé.

Pour plus d’informations sur l’utilisation des clés de Registre, consultez Utilisation du Registre dans un pilote.

Si l’appel à cette fonction se produit en mode utilisateur, vous devez utiliser le nom « NtDeleteKey » au lieu de « ZwDeleteKey ».

Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Utilisation des versions Nt et Zw des routines des services système natifs.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport),IrqlZwPassive(wdm), PowerIrpDDis(wdm), ZwRegistryCreate(storport),ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm)

Voir aussi

Utilisation des versions Nt et Zw des routines natives des services système natifs

ZwCreateKey

ZwOpenKey