Méthode IRegistryKey ::D eleteKey (portcls.h)

Article
03/01/2024

La DeleteKey méthode supprime la clé de Registre.

Syntaxe

NTSTATUS DeleteKey();

Valeur de retour

DeleteKey retourne STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié.

Remarques

Un appelant supprime la clé de Registre d’un objet IRegistryKey en appelant la DeleteKey méthode sur cet objet. La clé ne peut être supprimée que si l’appelant a créé la clé avec un ACCESS_MASK qui autorise la suppression. L’appelant active la suppression en spécifiant une valeur de paramètre DesiredAccess de KEY_ALL_ACCESS (décrit dans ZwCreateKey) à l’appel PcNewRegistryKey, IPort ::NewRegistryKey ou IRegistryKey ::NewSubKey qui crée la clé. Lors de la suppression d’une clé, l’objet IRegistryKey ignore son handle de clé de Registre, et tous les autres handles de la clé supprimée ne deviennent pas valides.