Función EnumDirTree (dbghelp.h)
Enumera todas las apariciones del archivo especificado en el árbol de directorios especificado.
Sintaxis
BOOL IMAGEAPI EnumDirTree(
[in, optional] HANDLE hProcess,
[in] PCSTR RootPath,
[in] PCSTR InputPathName,
[out, optional] PSTR OutputPathBuffer,
[in, optional] PENUMDIRTREE_CALLBACK cb,
[in, optional] PVOID data
);
Parámetros
[in, optional] hProcess
Identificador de un proceso. Este identificador debe haberse pasado previamente a la función SymInitialize .
[in] RootPath
Ruta de acceso donde la función debe comenzar a buscar el archivo.
[in] InputPathName
Nombre del archivo que se va a encontrar. Puede especificar una ruta de acceso parcial.
[out, optional] OutputPathBuffer
Puntero a un búfer que recibe la ruta de acceso completa del archivo. Si se produce un error en la función o no encuentra un archivo coincidente, este búfer seguirá conteniendo la última ruta de acceso completa que se encontró.
Este parámetro es opcional y puede ser NULL.
[in, optional] cb
Una función de devolución de llamada definida por la aplicación o NULL. Para obtener más información, vea EnumDirTreeProc.
[in, optional] data
Datos definidos por el usuario o NULL. Este valor se pasa a la función de devolución de llamada.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es TRUE.
Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.
Comentarios
La búsqueda se puede cancelar si registra una función de devolución de llamada SymRegisterCallbackProc64 . Para cada operación de archivo, EnumDirTree llama a esta función de devolución de llamada con CBA_DEFERRED_SYMBOL_LOAD_CANCEL. Si la función de devolución de llamada devuelve TRUE, EnumDirTree cancela la búsqueda.
Todas las funciones DbgHelp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.
Para llamar a la versión Unicode de esta función, defina DBGHELP_TRANSLATE_TCHAR.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | dbghelp.h |
| Library | Dbghelp.lib |
| Archivo DLL | Dbghelp.dll |
| Redistribuible | DbgHelp.dll 6.0 o posterior |