функция обратного вызова 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
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dbghelp.h |
| Распространяемые компоненты | DbgHelp.dll 5.1 или более поздней версии |