Compartir a través de

PSYM_ENUMSYMBOLS_CALLBACK64W función de devolución de llamada (dbghelp.h)

  • Artículo

Función de devolución de llamada definida por la aplicación que se usa con la función SymEnumerateSymbols64 . Se llama una vez para cada símbolo enumerado y recibe la información del símbolo.

Los tipos PSYM_ENUMSYMBOLS_CALLBACK64 y PSYM_ENUMSYMBOLS_CALLBACK64W definen un puntero a esta función de devolución de llamada. SymEnumerateSymbolsProc64 es un marcador de posición para el nombre de la función definida por la aplicación.

Nota Esta función solo se proporciona por motivos de compatibilidad. Las aplicaciones deben usar SymEnumSymbols.
 

Sintaxis

PSYM_ENUMSYMBOLS_CALLBACK64W PsymEnumsymbolsCallback64w;

BOOL PsymEnumsymbolsCallback64w(
  [in]           PCWSTR SymbolName,
  [in]           DWORD64 SymbolAddress,
  [in]           ULONG SymbolSize,
  [in, optional] PVOID UserContext
)
{...}

Parámetros

[in] SymbolName

Nombre del símbolo. El nombre se puede descodificar si la opción SYMOPT_UNDNAME se usa con la función SymSetOptions .

[in] SymbolAddress

Dirección virtual para el principio del símbolo.

[in] SymbolSize

Tamaño del símbolo, en bytes. El tamaño se calcula y es realmente un valor de estimación más adecuado. En algunos casos, el valor puede ser cero.

[in, optional] UserContext

Valor definido por el usuario especificado en SymEnumerateSymbols64 o NULL. Normalmente, una aplicación usa este parámetro para pasar un puntero a una estructura de datos que permite que la función de devolución de llamada establezca algún tipo de contexto.

Valor devuelto

Si la función devuelve TRUE, la enumeración continuará.

Si la función devuelve FALSE, la enumeración se detendrá.

Comentarios

Se llama a la aplicación que realiza la llamada una vez por símbolo hasta que se enumeran todos los símbolos o hasta que la función de devolución de llamada de enumeración devuelve FALSE.

Esta función de devolución de llamada sustituye a la función de devolución de llamada PSYM_ENUMSYMBOLS_CALLBACK . PSYM_ENUMSYMBOLS_CALLBACK se define de la siguiente manera en Dbghelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PSYM_ENUMSYMBOLS_CALLBACK PSYM_ENUMSYMBOLS_CALLBACK64
#define PSYM_ENUMSYMBOLS_CALLBACKW PSYM_ENUMSYMBOLS_CALLBACK64W
#else
typedef BOOL
(CALLBACK *PSYM_ENUMSYMBOLS_CALLBACK)(
    __in PCSTR SymbolName,
    __in ULONG SymbolAddress,
    __in ULONG SymbolSize,
    __in_opt PVOID UserContext
    );

typedef BOOL
(CALLBACK *PSYM_ENUMSYMBOLS_CALLBACKW)(
    __in PCWSTR SymbolName,
    __in ULONG SymbolAddress,
    __in ULONG SymbolSize,
    __in_opt PVOID UserContext
    );
#endif

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado dbghelp.h
Redistribuible DbgHelp.dll 5.1 o posterior

Consulte también

Funciones de DbgHelp

SymEnumSymbols

SymEnumerateSymbols64