RegDeleteKeyExA, fonction (winreg.h)
Supprime une sous-clé et ses valeurs de l’affichage spécifique à la plateforme spécifié du Registre. Notez que les noms de clés ne respectent pas la casse.
Pour supprimer une sous-clé en tant qu’opération transactionnée, appelez la fonction RegDeleteKeyTransacted .
Syntaxe
LSTATUS RegDeleteKeyExA(
[in] HKEY hKey,
[in] LPCSTR lpSubKey,
[in] REGSAM samDesired,
DWORD Reserved
);
Paramètres
[in] hKey
Handle vers une clé de Registre ouverte. Les droits d’accès de cette clé n’affectent pas l’opération de suppression. Pour plus d’informations sur les droits d’accès, consultez La sécurité de la clé de Registre et les droits d’accès.
Ce handle est retourné par la fonction RegCreateKeyEx ou RegOpenKeyEx , ou il peut s’agir de l’une des clés prédéfinies suivantes :
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_CONFIG
- HKEY_CURRENT_USER
- HKEY_LOCAL_MACHINE
- HKEY_USERS
[in] lpSubKey
Nom de la clé à supprimer. Cette clé doit être une sous-clé de la clé spécifiée par la valeur du paramètre hKey .
La fonction ouvre la sous-clé avec le droit d’accès DELETE.
Les noms de clés ne respectent pas la casse.
La valeur de ce paramètre ne peut pas être NULL.
[in] samDesired
Masque d’accès qui spécifie l’affichage spécifique à la plateforme du Registre.
| Valeur | Signification |
|---|---|
|
Supprimez la clé de la vue de Registre 32 bits. |
|
Supprimez la clé de la vue de Registre 64 bits. |
Reserved
Ce paramètre est réservé et doit être égal à zéro.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est un code d’erreur non zéro défini dans Winerror.h. Vous pouvez utiliser la fonction FormatMessage avec l’indicateur FORMAT_MESSAGE_FROM_SYSTEM pour obtenir une description générique de l’erreur.
Remarques
Une clé supprimée n’est pas supprimée tant que la dernière poignée n’est pas fermée.
Sur WOW64, les applications 32 bits affichent une arborescence de Registre distincte de l’arborescence de Registre qui affiche les applications 64 bits. Cette fonction permet à une application de supprimer une entrée dans la vue de Registre de remplacement.
La sous-clé à supprimer ne doit pas avoir de sous-clés. Pour supprimer une clé et toutes ses sous-clés, vous devez énumérer les sous-clés et les supprimer individuellement. Pour supprimer des clés récursivement, utilisez la fonction RegDeleteTree ou SHDeleteKey .
Si la fonction réussit, RegDeleteKeyEx supprime la clé spécifiée du Registre. La clé entière, y compris toutes ses valeurs, est supprimée.
Notes
Sur les versions héritées de Windows, cette API est également exposée par kernel32.dll.
Notes
L’en-tête winreg.h définit RegDeleteKeyEx comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Client minimal pris en charge | Windows Vista, Windows XP Professional x64 Edition [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winreg.h (inclure Windows.h) |
| Bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |