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


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

Определяемая приложением функция обратного вызова, используемая с функциями 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Целевая платформа Windows
Header dbghelp.h
Распространяемые компоненты DbgHelp.dll 5.1 или более поздней версии

См. также раздел

Функции DbgHelp

SYMBOL_INFO

SymEnumSymbols

SymEnumTypes

SymEnumTypesByName