IDebugEventCallbacks::ChangeSymbolState-Methode (dbgeng.h)

  • Artikel

Die ChangeSymbolState-Rückrufmethode wird von der Engine aufgerufen, wenn sich der Symbolzustand ändert.

Syntax

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

Parameter

[in] Flags

Gibt einen Bitsatz an, der die Art der Änderung des Symbolzustands angibt. Die folgenden Bitflags können festgelegt werden.

Wert BESCHREIBUNG
DEBUG_CSS_LOADS Die Engine hat einige Modulsymbole geladen.
DEBUG_CSS_UNLOADS Die Engine hat einige Modulsymbole entladen.
DEBUG_CSS_SCOPE Der aktuelle Symbolbereich wurde geändert.
DEBUG_CSS_PATHS Die ausführbaren Bild-, Quell- oder Symbolsuchpfade wurden geändert.
DEBUG_CSS_SYMBOL_OPTIONS Die Symboloptionen wurden geändert.
DEBUG_CSS_TYPE_OPTIONS Die Typoptionen haben sich geändert.

[in] Argument

Stellt zusätzliche Informationen zur Änderung des Symbolzustands bereit. Wenn im Flags-Parameter mehrere Bitflags festgelegt sind, wird der Argument-Parameter nicht verwendet. Andernfalls hängt der Wert von Argument vom Wert von Flags ab:

DEBUG_CSS_LOADS

Der Wert von Argument ist der Basisspeicherort (im Speicheradressraum des Ziels) des Modulbilds, für das die Engine Symbole geladen hat.

DEBUG_CSS_UNLOADS

Der Wert von Argument ist der Basisspeicherort (im Speicheradressraum des Ziels) des Modulbilds, für das die Engine Symbole entladen hat. Wenn die Engine Symbole für mehrere Bilder entladen, ist der Wert von Argument null.

DEBUG_CSS_SCOPE

Der Wert von Argument ist null.

DEBUG_CSS_PATHS

Der Wert von Argument ist null.

DEBUG_CSS_SYMBOL_OPTIONS

Der Wert von Argument ist die Symboloptionen.

DEBUG_CSS_TYPE_OPTIONS

Der Wert von Argument ist null.

Rückgabewert

Der Rückgabewert wird von der Engine ignoriert, es sei denn, er weist auf einen Remoteprozeduraufruffehler hin. In diesem Fall ist der Client, bei dem dieses IDebugEventCallbacks-Objekt registriert ist, deaktiviert.

Hinweise

Diese Methode wird nur von der Engine aufgerufen, wenn das DEBUG_EVENT_CHANGE_SYMBOL_STATE-Flag in der von IDebugEventCallbacks::GetInterestMask zurückgegebenen Maske festgelegt ist.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter Überwachen von Ereignissen.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (dbgeng.h einschließen)