SearchTreeForFile

SearchTreeForFile 関数 (dbghelp.h) は、ディレクトリツリー内から指定したファイルを検索する。

SearchTreeForFile RootPath, InputPathName, OutputPathBuffer

RootPath : [str] ファイル検索を開始するパス。
InputPathName : [str] 関数が検索するファイル。部分パスを指定できる。
OutputPathBuffer : [str] 見つかったファイルのフルパスを受け取るバッファへのポインター。戻り値が FALSE の場合、この文字列は変更されない。

(プラグイン / モジュール : dbghelp.dll)

解説

SearchTreeForFile 関数 (dbghelp.h) は、ディレクトリツリー内から指定したファイルを検索する。

[戻り値]
関数が成功した場合、戻り値は TRUE となる。関数が失敗した場合、戻り値は FALSE となる。拡張エラー情報を取得するには
GetLastError を呼び出す。

[備考]
関数は RootPath パラメーターで指定されたパスを起点として、InputPathName
パラメーターで指定されたファイルを検索する。RootPath で許容される最大パス深度は 32
ディレクトリである。ディレクトリツリー内でファイルが見つかると、OutputPathBuffer
パラメーターで指定されたバッファにフルパスが格納される。サブディレクトリの検索順序は基盤のファイルシステムに依存する。SymRegisterCallbackProc64
コールバック関数を登録しておけば検索をキャンセルできる。SearchTreeForFile
は検索対象のディレクトリごとに、このコールバック関数を CBA_DEFERRED_SYMBOL_LOAD_CANCEL
で呼び出す。コールバック関数が TRUE を返すと SearchTreeForFile
は検索をキャンセルする。この関数は検索対象ディレクトリごとに 1 回 CBA_DEFERRED_SYMBOL_LOAD_CANCEL
イベントを発生させる。これにより呼び出し側は検索をキャンセルできる。DbgHelp
関数はすべて、この関数を含めシングルスレッドである。したがって複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を引き起こす可能性が高い。これを避けるため、複数スレッドからの同時呼び出しはすべて同期する必要がある。Unicode
版を呼び出すには DBGHELP_TRANSLATE_TCHAR を定義する。

情報