Freigeben über

IDebugEventCallbacksWide::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 Symbol-Suchpfade wurden geändert.
DEBUG_CSS_SYMBOL_OPTIONS Die Symboloptionen wurden geändert.
DEBUG_CSS_TYPE_OPTIONS Die Typoptionen wurden geändert.

[in] Argument

Stellt zusätzliche Informationen zur Änderung des Symbolstatus 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 Modulimages, für das die Engine Symbole geladen hat.

DEBUG_CSS_UNLOADS

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

DEBUG_CSS_SCOPE

Der Wert von Argument ist 0.

DEBUG_CSS_PATHS

Der Wert von Argument ist 0.

DEBUG_CSS_SYMBOL_OPTIONS

Der Wert von Argument ist die Symboloptionen.

DEBUG_CSS_TYPE_OPTIONS

Der Wert von Argument ist 0.

Rückgabewert

Der Rückgabewert wird vom Modul ignoriert, es sei denn, er weist auf einen Remoteprozeduraufruffehler hin. in diesem Fall ist der Client, bei dem dieses IDebugEventCallbacksWide-Objekt registriert ist, deaktiviert.

Hinweise

Diese Methode wird von der Engine nur aufgerufen, wenn das DEBUG_EVENT_CHANGE_SYMBOL_STATE-Flag in der von IDebugEventCallbacksWide::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 (einschließlich Dbgeng.h)