コールバック関数PSYM_ENUMMODULES_CALLBACK (dbghelp.h)

SymEnumerateModules64 関数で使用されるアプリケーション定義のコールバック関数。 列挙モジュールごとに 1 回呼び出され、モジュール情報を受け取ります。

PSYM_ENUMMODULES_CALLBACK64型とPSYM_ENUMMODULES_CALLBACKW64型は、このコールバック関数へのポインターを定義します。 SymEnumerateModulesProc64 は、アプリケーション定義関数名のプレースホルダーです。

構文

PSYM_ENUMMODULES_CALLBACK PsymEnummodulesCallback;

BOOL PsymEnummodulesCallback(
  [in]           PCSTR ModuleName,
  [in]           ULONG BaseOfDll,
  [in, optional] PVOID UserContext
)
{...}

パラメーター

[in] ModuleName

モジュールの名前です。

[in] BaseOfDll

モジュールがメモリに読み込まれるベース アドレス。

[in, optional] UserContext

SymEnumerateModules64 または NULL で指定されたユーザー定義値。 通常、このパラメーターは、コールバック関数が何らかの種類のコンテキストを確立できるようにするデータ構造へのポインターを渡すためにアプリケーションによって使用されます。

戻り値

戻り値が TRUE の場合、列挙は続行されます。

戻り値が FALSE の場合、列挙は停止します。

注釈

呼び出し元のアプリケーションは、すべてのモジュールが列挙されるまで、または列挙コールバック関数が FALSE を返すまで、モジュールごとに 1 回呼び出されます。

このコールバック関数は 、PSYM_ENUMMODULES_CALLBACK コールバック関数よりも優先されます。 PSYM_ENUMMODULES_CALLBACK は、DbgHelp.h で次のように定義されています。

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PSYM_ENUMMODULES_CALLBACK PSYM_ENUMMODULES_CALLBACK64
#else
typedef BOOL
(CALLBACK *PSYM_ENUMMODULES_CALLBACK)(
    __in PCSTR ModuleName,
    __in ULONG BaseOfDll,
    __in_opt PVOID UserContext
    );
#endif

要件

こちらもご覧ください

DbgHelp 関数

SymEnumerateModules64