UDF > WinAPIEx > Registry >


_WinAPI_RegDeleteTreeEx

Supprime, de manière récursive, les sous-clés et les valeurs de la clé spécifiée

#include <WinAPIReg.au3>
_WinAPI_RegDeleteTreeEx ( $hKey [, $sSubKey = 0] )

Paramètres

$hKey Handle de la clé de registre ouverte. La clé doit avoir été ouverte avec les droits d'accès suivants:
$DELETE $KEY_ENUMERATE_SUB_KEYS, et $KEY_QUERY_VALUE.
Ce handle est retourné par la fonction _WinAPI_RegCreateKey() ou _WinAPI_RegOpenKey(), ou bien il peut être l'une des clés prédéfinis suivantes:
$HKEY_CLASSES_ROOT
$HKEY_CURRENT_CONFIG
$HKEY_CURRENT_USER
$HKEY_LOCAL_MACHINE
$HKEY_USERS
$sSubKey [optionnel] Le nom de la clé à supprimer. Cette clé doit être une sous-clé de la clé identifiée par le paramètre $hKey.
Si ce paramètre n'est pas spécifié (par défaut), les sous-clés et valeurs de $hKey sont supprimées.

Valeur de retour

Succès: Retourne 1.
Échec: Retourne 0 et définit @error <> 0, @extended peut contenir le code d'erreur du système.

Remarques

Si la clé a des valeurs, elle doit être ouverte avec $KEY_SET_VALUE ou cette fonction échouera.

Cette fonction nécessite Windows Vista ou une version ultérieure.

En relation

_WinAPI_RegCreateKey, _WinAPI_RegOpenKey

Voir aussi

Consultez RegDeleteTree dans la librairie MSDN.