функция обратного вызова PSYM_ENUMERATESYMBOLS_CALLBACKW (dbghelp.h)

Статья
11/20/2024

Функция обратного вызова, определяемая приложением, используемая с SymEnumSymbols, SymEnumTypes и функциями SymEnumTypesByName.

Типы PSYM_ENUMERATESYMBOLS_CALLBACK и PSYM_ENUMERATESYMBOLS_CALLBACKW определяют указатель на эту функцию обратного вызова. SymEnumSymbolsProc является заполнителем для имени функции, определяемой приложением.

Синтаксис

PSYM_ENUMERATESYMBOLS_CALLBACKW PsymEnumeratesymbolsCallbackw;

BOOL PsymEnumeratesymbolsCallbackw(
  [in]           PSYMBOL_INFOW pSymInfo,
  [in]           ULONG SymbolSize,
  [in, optional] PVOID UserContext
)
{...}

Параметры

[in] pSymInfo

Указатель на SYMBOL_INFO структуру, которая предоставляет сведения о символе.

[in] SymbolSize

Размер символа в байтах. Размер вычисляется и на самом деле является предположением. В некоторых случаях это значение может быть равно нулю.

[in, optional] UserContext

Определяемое пользователем значение, переданное из функции SymEnumSymbols или SymEnumTypes или NULL. Этот параметр обычно используется приложением для передачи указателя на структуру данных, которая предоставляет контекстную информацию для функции обратного вызова.

Возвращаемое значение

Если функция возвращает TRUE, перечисление продолжится.

Если функция возвращает FALSE, перечисление остановится.

Замечания

Заметка

Заголовок dbghelp.h определяет PSYM_ENUMERATESYMBOLS_CALLBACK как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	dbghelp.h
распространяемый	DbgHelp.dll 5.1 или более поздней версии

См. также

функций DbgHelp

Поделиться через