PSYM_ENUMERATESYMBOLS_CALLBACKW funzione di callback (dbghelp.h)

2024-11-20

Funzione di callback definita dall'applicazione usata con le funzioni SymEnumSymbols , SymEnumTypese SymEnumTypesByName.

I tipi PSYM_ENUMERATESYMBOLS_CALLBACK e PSYM_ENUMERATESYMBOLS_CALLBACKW definiscono un puntatore a questa funzione di callback. SymEnumSymbolsProc è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PSYM_ENUMERATESYMBOLS_CALLBACKW PsymEnumeratesymbolsCallbackw;

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

Parametri

[in] pSymInfo

Puntatore a una struttura SYMBOL_INFO che fornisce informazioni sul simbolo.

[in] SymbolSize

Dimensione del simbolo, in byte. La dimensione viene calcolata ed è in realtà un'ipotesi. In alcuni casi, questo valore può essere zero.

[in, optional] UserContext

Valore definito dall'utente passato dalla funzione SymEnumSymbols o SymEnumTypes o NULL. Questo parametro viene in genere usato da un'applicazione per passare un puntatore a una struttura di dati che fornisce informazioni di contesto per la funzione di callback.

Valore restituito

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

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

Osservazioni

Nota

L'intestazione dbghelp.h definisce PSYM_ENUMERATESYMBOLS_CALLBACK come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.