PSYM_ENUMMODULES_CALLBACK回呼函式 (dbghelp.h)

搭配 SymEnumerateModules64 函式使用的應用程式定義回呼函式。 它會針對每個列舉模組呼叫一次，並接收模組資訊。

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 為止。

此回呼函式會取代 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