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

EnumerateLoadedModules64 関数で使用されるアプリケーション定義のコールバック関数。

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

構文

PENUMLOADED_MODULES_CALLBACK PenumloadedModulesCallback;

BOOL PenumloadedModulesCallback(
  [in]           PCSTR ModuleName,
  [in]           ULONG ModuleBase,
  [in]           ULONG ModuleSize,
  [in, optional] PVOID UserContext
)
{...}

パラメーター

[in] ModuleName

列挙モジュールの名前。

[in] ModuleBase

モジュールのベース アドレス。 このアドレスが無効になる可能性があることに注意してください (たとえば、モジュールがアンロードされる可能性があります)。 アドレスにアクセスするとき、またはアドレスを別の関数に渡すときに例外処理を使用して、アクセス違反が発生しないようにします。

[in] ModuleSize

モジュールのサイズ (バイト単位)。

[in, optional] UserContext

オプションのユーザー定義データ。 この値は EnumerateLoadedModules64 から渡されます。

戻り値

列挙を続行するには、コールバック関数が TRUE を返す必要があります。

列挙を停止するには、コールバック関数が FALSE を返す必要があります。

解説

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

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PENUMLOADED_MODULES_CALLBACK PENUMLOADED_MODULES_CALLBACK64
#else
typedef BOOL (CALLBACK *PENUMLOADED_MODULES_CALLBACK)(
    __in PCSTR ModuleName,
    __in ULONG ModuleBase,
    __in ULONG ModuleSize,
    __in_opt PVOID UserContext
    );
#endif

要件

対象プラットフォーム	Windows
ヘッダー	dbghelp.h
再頒布可能パッケージ	DbgHelp.dll 5.1 以降

関連項目

DbgHelp 関数

EnumerateLoadedModules64