Condividi tramite

Metodo IDebugEventCallbacksWide::ChangeSymbolState (dbgeng.h)

  • Articolo

Il metodo di callback ChangeSymbolState viene chiamato dal motore quando lo stato del simbolo cambia.

Sintassi

HRESULT ChangeSymbolState(
  [in] ULONG   Flags,
  [in] ULONG64 Argument
);

Parametri

[in] Flags

Specifica un set di bit che indica la natura della modifica allo stato del simbolo. È possibile impostare i flag di bit seguenti.

Valore Descrizione
DEBUG_CSS_LOADS Il motore ha caricato alcuni simboli del modulo.
DEBUG_CSS_UNLOADS Il motore ha scaricato alcuni simboli di modulo.
DEBUG_CSS_SCOPE L'ambito del simbolo corrente è stato modificato.
DEBUG_CSS_PATHS I percorsi di ricerca dell'immagine eseguibile, dell'origine o dei simboli sono stati modificati.
DEBUG_CSS_SYMBOL_OPTIONS Le opzioni dei simboli sono state modificate.
DEBUG_CSS_TYPE_OPTIONS Le opzioni del tipo sono state modificate.

[in] Argument

Fornisce informazioni aggiuntive sulla modifica allo stato del simbolo. Se nel parametro flag Flags è impostato più flag di bit, il parametro argument non viene utilizzato. In caso contrario, il valore di Argument dipende dal valore di Flag:

DEBUG_CSS_LOADS

Il valore di Argument è il percorso di base (nello spazio degli indirizzi di memoria della destinazione) dell'immagine del modulo per cui il motore ha caricato i simboli.

DEBUG_CSS_UNLOADS

Il valore di Argument è il percorso di base (nello spazio indirizzi di memoria della destinazione) dell'immagine del modulo per cui il motore ha scaricato i simboli. Se il motore scarica simboli per più immagini, il valore di Argument è zero.

DEBUG_CSS_SCOPE

Il valore di Argument è zero.

DEBUG_CSS_PATHS

Il valore di Argument è zero.

DEBUG_CSS_SYMBOL_OPTIONS

Il valore di Argument è rappresentato dalle opzioni del simbolo.

DEBUG_CSS_TYPE_OPTIONS

Il valore di Argument è zero.

Valore restituito

Il valore restituito viene ignorato dal motore a meno che non indichi un errore di chiamata di procedura remota; in questo caso il client, con cui viene registrato questo oggetto IDebugEventCallbacksWide, è disabilitato.

Osservazioni

Questo metodo viene chiamato dal motore solo se il flag DEBUG_EVENT_CHANGE_SYMBOL_STATE è impostato nella maschera restituita da IDebugEventCallbacksWide::GetInterestMask.

Per altre informazioni sulla gestione degli eventi, vedere Monitoraggio eventi.

Fabbisogno

Requisito Valore
piattaforma di destinazione Desktop
intestazione dbgeng.h (include Dbgeng.h)