PSYM_ENUMSYMBOLS_CALLBACK funzione di callback (dbghelp.h)

Funzione callback definita dall'applicazione usata con la funzione SymEnumerateSymbols64 . Viene chiamato una volta per ogni simbolo enumerato e riceve le informazioni sul simbolo.

I tipi PSYM_ENUMSYMBOLS_CALLBACK64 e PSYM_ENUMSYMBOLS_CALLBACK64W definiscono un puntatore a questa funzione di callback. SymEnumerateSymbolsProc64 è un segnaposto per il nome della funzione definito dall'applicazione.

Sintassi

PSYM_ENUMSYMBOLS_CALLBACK PsymEnumsymbolsCallback;

BOOL PsymEnumsymbolsCallback(
  [in]           PCSTR SymbolName,
  [in]           ULONG SymbolAddress,
  [in]           ULONG SymbolSize,
  [in, optional] PVOID UserContext
)
{...}

Parametri

[in] SymbolName

Nome del simbolo. Il nome può essere nondecorato se l'opzione SYMOPT_UNDNAME viene usata con la funzione SymSetOptions .

[in] SymbolAddress

Indirizzo virtuale per l'inizio del simbolo.

[in] SymbolSize

Dimensioni del simbolo, in byte. La dimensione viene calcolata ed è in realtà un valore migliore per indovinare. In alcuni casi, il valore può essere zero.

[in, optional] UserContext

Valore definito dall'utente specificato in SymEnumerateSymbols64 o NULL. In genere, questo parametro viene usato da un'applicazione per passare un puntatore a una struttura di dati che consente alla funzione di callback di stabilire un tipo di contesto.

Valore restituito

Se la funzione restituisce TRUE, l'enumerazione continuerà.

Se la funzione restituisce FALSE, l'enumerazione verrà arrestata.

Commenti

L'applicazione chiamante viene chiamata una volta per simbolo fino a quando non vengono enumerati tutti i simboli o finché la funzione di callback dell'enumerazione restituisce FALSE.

Questa funzione di callback sostituisce la funzione di callback PSYM_ENUMSYMBOLS_CALLBACK . PSYM_ENUMSYMBOLS_CALLBACK è definito come indicato di seguito in 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

Requisiti

Vedi anche

Funzioni DbgHelp

SymEnumSymbols

SymEnumerateSymbols64