RegDeleteTree

Esta función no es más que una forma recursiva que tiene la API de Windows para utilizar RegOpenKeyEx, RegEnumKeyEx (Aún no documentada aquí en Wiki) y RegDeleteKeyEx con el objetivo de abrir una Clave indicada en la función, enumerar todas las sub-claves que tenga y eliminarlas una por una junto con sus respectivos Valores de Registro. Quiere decir que podría utilizar la combinación de las tres para llevar a cabo la operación, o bien llamar a esta función que hará el trabajo fácil y rápido, aunque puede ser necesario, de acuerdo a la clave que se le vaya a eliminar sub-claves, utilizar de todas formas la función RegOpenKeyEx. Windows internamente utiliza estas funciones cuando se está trabajando desde el Editor de Registro.

Esta función es la que se debe utilizar cuando queramos borrar todo un árbol de sub-claves, ya que RegDeleteKeyEx vista en otro artículo de Wiki, solo permite borrar una sola sub-clave indicada con todos sus valores.

Declaración

Esta función es realmente sencilla de utilizar, y solo requiere dos variables:

HKEY hKey: Siempre representa el apuntador a una clave de registro que se haya abierto con RegCreateKeyEx o RegOpenKeyEx, aunque también puede tomarse alguna de las ramas predefinidas:

HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS

Si se utiliza RegCreateKeyEx o RegOpenKeyEx, tendríamos que usar la variable declarada de phkResult que tiene el apuntador a toda la clave.

LPCTSTR lpSubKey: Para esta variable es necesario indicarle cuál es el nombre exacto de la clave a la que se le eliminarán todas las sub-claves. Por ejemplo, si deseamos eliminar todo lo que esté dentro de MiSubClave, ubicada en HKEY_CURRENT_USER\MiClave, la declararíamos como: "MiSubClave", pues hKey tendría el retorno de HKEY_CURRENT_USER\MiClave.

Ejemplo práctico

Para ver en acción esta función como corresponde, supongamos que tenemos una clave sub-clave llamada APrincipal en HKEY_CURRENT_USER, y dentro de esta tenemos a la vez dos sub-claves más llamadas Borrar y NoBorrar. Dentro de borrar existe una última sub-clave denominada BorrarA y tiene un valor de tipo DWORD llamado ValorABorrar. La siguiente imagen ilustra un poco lo explicado anteriormente:




Nota: Lo ideal es que creen las claves y valores para hacer las pruebas.

Como el proceso siempre es Abrir > Eliminar, tenemos que abrir la clave HKEY_CURRENT_USER\APrincipal y eliminar todo el árbol que tenga la sub-clave Borrar.

Las declaraciones, según lo explicado anteriormente, y de acuerdo a lo que ya escribí en el artículo dedicado a RegOpenKeyEx, quedarían así:

Nota: Por supuesto hay que tener en cuenta la declaración del método principal.

Lo primero es buscar y abrir la clave principal, que sería: HKEY_CURRENT_USER\APrincipal, y esto se hace con RegOpenKeyEx llamando la función y enviándole los valores declarados. Para que podamos controlar el resultado, lo guardamos como siempre en una variable R1 de tipo long:


Con un switch podemos tomar las decisiones adecuadas de acuerdo al código que devuelva RegOpenKeyEx. Si el ID es ERROR_SUCCESS, procedemos a eliminar el árbol y a indicarlo con sus respectivas comprobaciones, de lo contrario, indicamos mensaje para algunos errores genéricos.

El código completo sería:


El mensaje al eliminar la sub-clave con el código anterior se vería así:

Explorando resultados

Después de que la operación sea exitosa, podemos ver fácilmente con Process Monitor cómo Windows realmente la hace: