Função SearchTreeForFileW (dbghelp.h)

Pesquisa uma árvore de diretório em busca de um arquivo especificado.

Sintaxe

BOOL IMAGEAPI SearchTreeForFileW(
  [in]  PCWSTR RootPath,
  [in]  PCWSTR InputPathName,
  [out] PWSTR  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 de retorno

Se a função for bem-sucedida, o valor retornado será VERDADEIRO.

Se a função falhar, o valor retornado será false. Para recuperar informações de erro estendidas, chame GetLastError.

Observações

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 simples. 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.

Nota

O cabeçalho dbghelp.h define SearchTreeForFile como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	dbghelp.h
biblioteca	Dbghelp.lib
de DLL	Dbghelp.dll
redistribuível	DbgHelp.dll 5.1 ou posterior

Consulte também

do DbgHelp Functions