Condividi tramite

Metodo IDebugEventCallbacksWide::ChangeSymbolState (dbgeng.h)

  • Articolo

Il metodo 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 del modulo.
DEBUG_CSS_SCOPE L'ambito del simbolo corrente è stato modificato.
DEBUG_CSS_PATHS L'immagine eseguibile, l'origine o i percorsi di ricerca dei simboli sono stati modificati.
DEBUG_CSS_SYMBOL_OPTIONS Le opzioni dei simboli sono state modificate.
DEBUG_CSS_TYPE_OPTIONS Le opzioni di tipo sono state modificate.

[in] Argument

Fornisce informazioni aggiuntive sulla modifica allo stato del simbolo. Se nel parametro Flags viene impostato più flag di bit, il parametro Argument non viene usato. 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 degli indirizzi di memoria della destinazione) dell'immagine del modulo per cui il motore ha scaricato i simboli. Se il motore ha scaricato 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 è le 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 routine remota; In questo caso, il client, con cui viene registrato questo oggetto IDebugEventCallbacksWide , è disabilitato.

Commenti

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

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

Requisiti

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