Función EnumDirTreeW (dbghelp.h)
Enumera todas las apariciones del archivo especificado en el árbol de directorios especificado.
Sintaxis
BOOL IMAGEAPI EnumDirTreeW(
[in, optional] HANDLE hProcess,
[in] PCWSTR RootPath,
[in] PCWSTR InputPathName,
[out, optional] PWSTR OutputPathBuffer,
[in, optional] PENUMDIRTREE_CALLBACKW cb,
[in, optional] PVOID data
);
Parámetros
[in, optional] hProcess
Identificador de un proceso. Este identificador debe haberse pasado previamente a la función
[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á contiene la última ruta de acceso completa que se encontró.
Este parámetro es opcional y se puede 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
Los 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.
Observaciones
La búsqueda se puede cancelar si registra un SymRegisterCallbackProc64 función de devolución de llamada. 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 solo subproceso. Por lo tanto, las llamadas de más de un subproceso a esta función probablemente provocarán un comportamiento inesperado o daños en la memoria. Para evitar esto, 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.
Nota
El encabezado dbghelp.h define EnumDirTree como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de |
Windows |
| encabezado de |
dbghelp.h |
| biblioteca de |
Dbghelp.lib |
| DLL de |
Dbghelp.dll |
| redistribuible | DbgHelp.dll 6.0 o posterior |