Win32 API 日本語リファレンス
ホーム › System.Diagnostics.Debug › PSYM_ENUMMODULES_CALLBACK

PSYM_ENUMMODULES_CALLBACK

コールバック

シグネチャ

BOOL PSYM_ENUMMODULES_CALLBACK(
    LPSTR ModuleName,
    DWORD BaseOfDll,
    void* UserContext
);

パラメーター

フィールド型説明
ModuleNameLPSTRモジュールの名前です。
BaseOfDllDWORDモジュールがメモリに読み込まれているベースアドレスです。
UserContextvoid*SymEnumerateModules64 で指定されたユーザー定義の値、または NULL です。通常このパラメーターは、コールバック関数が何らかのコンテキストを確立できるように、アプリケーションがデータ構造体へのポインターを渡す目的で使用します。

公式ドキュメント

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

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

戻り値

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

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

解説(Remarks)

呼び出し元のアプリケーションは、すべてのモジュールが列挙されるまで、または列挙コールバック関数が 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
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)