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