EnumDirTreeW 関数 (dbghelp.h)

指定したディレクトリ ツリー内の指定したファイルのすべての出現箇所を列挙します。

構文

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
);

パラメーター

[in, optional] hProcess

プロセスへのハンドル。 このハンドルは、SymInitialize 関数に渡しておく必要があります。

[in] RootPath

関数がファイルの検索を開始するパス。

[in] InputPathName

見つかるファイルの名前。 部分パスを指定できます。

[out, optional] OutputPathBuffer

ファイルの完全なパスを受け取るバッファーへのポインター。 関数が失敗した場合、または一致するファイルが見つからない場合、このバッファーには、検出された最後の完全なパスが引き続き含まれます。

このパラメーターは省略可能であり、NULLできます。

[in, optional] cb

アプリケーション定義のコールバック関数、または NULL。 詳細については、「EnumDirTreeProcを参照してください。

[in, optional] data

ユーザー定義データまたは NULL。 この値はコールバック関数に渡されます。

戻り値

関数が成功した場合、戻り値は TRUE。

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

備考

SymRegisterCallbackProc64 コールバック関数を登録すると、検索を取り消すことができます。 すべてのファイル操作について、EnumDirTree 、このコールバック関数を CBA_DEFERRED_SYMBOL_LOAD_CANCEL で呼び出します。 コールバック関数が TRUE返した場合、EnumDirTree 検索が取り消されます。

この関数など、すべての DbgHelp 関数はシングル スレッドです。 そのため、複数のスレッドからこの関数を呼び出すと、予期しない動作やメモリ破損が発生する可能性があります。 これを回避するには、複数のスレッドからのすべての同時呼び出しをこの関数に同期する必要があります。

この関数の Unicode バージョンを呼び出すには、DBGHELP_TRANSLATE_TCHARを定義します。

手記

dbghelp.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして EnumDirTree を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	dbghelp.h
ライブラリ	Dbghelp.lib
DLL	Dbghelp.dll
再頒布可能パッケージの	DbgHelp.dll 6.0 以降

関連項目

DbgHelp 関数 の

EnumDirTreeProc の