Função SearchTreeForFile (dbghelp.h)
Pesquisa uma árvore de diretório em busca de um arquivo especificado.
Sintaxe
BOOL IMAGEAPI SearchTreeForFile(
[in] PCSTR RootPath,
[in] PCSTR InputPathName,
[out] PSTR OutputPathBuffer
);
Parâmetros
[in] RootPath
O caminho em que a função deve começar a pesquisar o arquivo.
[in] InputPathName
O arquivo para o qual a função será pesquisada. Você pode usar um caminho parcial.
[out] OutputPathBuffer
Um ponteiro para um buffer que recebe o caminho completo para o arquivo encontrado. Essa cadeia de caracteres não será modificada se o valor retornado for FALSE.
Valor retornado
Se a função for bem-sucedida, o valor retornado será TRUE.
Se a função falhar, o valor retornado será FALSE. Para recuperar informações de erro estendidas, chame GetLastError.
Comentários
A função pesquisa o arquivo especificado pelo parâmetro InputPathName começando no caminho especificado no parâmetro RootPath . A profundidade máxima do caminho permitida no RootPath é de 32 diretórios. Quando a função localiza o arquivo na árvore de diretório, ela coloca o caminho completo para o arquivo no buffer especificado pelo parâmetro OutputPathBuffer . O sistema de arquivos subjacente especifica a ordem da pesquisa de subdiretório.
A pesquisa poderá ser cancelada se você registrar uma função de retorno de chamada SymRegisterCallbackProc64 . Para cada diretório pesquisado, SearchTreeForFile chama essa função de retorno de chamada com CBA_DEFERRED_SYMBOL_LOAD_CANCEL. Se a função de retorno de chamada retornar TRUE, SearchTreeForFile cancelará a pesquisa.
Essa função dispara um evento CBA_DEFERRED_SYMBOL_LOAD_CANCEL por diretório pesquisado. Isso permite que o chamador cancele a pesquisa.
Todas as funções DbgHelp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.
Para chamar a versão Unicode dessa função, defina DBGHELP_TRANSLATE_TCHAR.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | dbghelp.h |
| Biblioteca | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Redistribuível | DbgHelp.dll 5.1 ou posterior |