Metodo IDebugEventCallbacks::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 di 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 Flags sono impostati più flag di bit, il parametro Argument non viene utilizzato. In caso contrario, il valore di Argument dipende dal valore di Flags:

DEBUG_CSS_LOADS

Il valore di Argument è il percorso di base (nello spazio 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 di indirizzi di memoria della destinazione) dell'immagine del modulo per cui il motore ha scaricato i simboli. Se il motore scarica i simboli per più di un'immagine, 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 è l'opzione 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 l'oggetto IDebugEventCallbacks , è disabilitato.

Commenti

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

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

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione dbgeng.h (include Dbgeng.h)