RegDeleteKeyTransactedA, fonction (winreg.h)

Article
11/20/2024

Supprime une sous-clé et ses valeurs de la vue spécifique à la plateforme spécifiée du Registre en tant qu’opération transactionnelle. Notez que les noms de clés ne respectent pas la casse.

Syntaxe

LSTATUS RegDeleteKeyTransactedA(
  [in] HKEY   hKey,
  [in] LPCSTR lpSubKey,
  [in] REGSAM samDesired,
       DWORD  Reserved,
  [in] HANDLE hTransaction,
       PVOID  pExtendedParameter
);

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 Sécurité des clés de Registre et droits d’accès.

Ce handle est retourné par le RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyExou fonction RegOpenKeyTransacted. Il peut également s’agir de l’une des clés prédéfinies:

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 la vue spécifique à la plateforme du Registre.

Valeur	Signification
KEY_WOW64_32KEY 0x0200	Supprimez la clé de la vue de Registre 32 bits.
KEY_WOW64_64KEY 0x0100	Supprimez la clé de la vue de Registre 64 bits.

Reserved

Ce paramètre est réservé et doit être égal à zéro.

[in] hTransaction

Handle vers une transaction active. Ce handle est retourné par la fonction CreateTransaction.

pExtendedParameter

Ce paramètre est réservé et doit être NULL.

Valeur de retour

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 différent de zéro défini dans Winerror.h. Vous pouvez utiliser la fonction FormatMessage avec l’indicateur de 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 l’autre vue du Registre.

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 de manière récursive, utilisez la fonction RegDeleteTree ou SHDeleteKey.

Si la fonction réussit, RegDeleteKeyTransacted supprime la clé spécifiée du Registre. La clé entière, y compris toutes ses valeurs, est supprimée. Pour supprimer l’arborescence entière en tant qu’opération transactionnelle, utilisez la fonction RegDeleteTree avec un handle retourné par RegCreateKeyTransacted ou RegOpenKeyTransacted.

Note

L’en-tête winreg.h définit RegDeleteKeyTransacted 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. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winreg.h (inclure Windows.h)
bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

RegCreateKeyTransacted

RegOpenKeyTransacted

fonctions de Registre

redirecteur de Registre

Partager via