Freigeben über

IDebugEventCallbacksWide::ChangeSymbolState-Methode (dbgeng.h)

  • Artikel

Die ChangeSymbolState- Rückrufmethode wird vom Modul aufgerufen, wenn sich der Symbolstatus ändert.

Syntax

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

Parameter

[in] Flags

Gibt einen Bitsatz an, der die Art der Änderung an den Symbolstatus angibt. Die folgenden Bitkennzeichnungen können festgelegt werden.

Wert Beschreibung
DEBUG_CSS_LOADS Das Modul hat einige Modulsymbole geladen.
DEBUG_CSS_UNLOADS Das Modul hat einige Modulsymbole entladen.
DEBUG_CSS_SCOPE Der aktuelle Symbolbereich wurde geändert.
DEBUG_CSS_PATHS Die Pfade für ausführbare Bilder, Quellen oder Symbole wurden geändert.
DEBUG_CSS_SYMBOL_OPTIONS Die Symboloptionen wurden geändert.
DEBUG_CSS_TYPE_OPTIONS Die Typoptionen wurden geändert.

[in] Argument

Enthält zusätzliche Informationen zur Änderung des Symbolzustands. Wenn mehr als ein Bit-Flag im parameter Flags festgelegt ist, wird der parameter Argument nicht verwendet. Andernfalls hängt der Wert Argument vom Wert Flagsab:

DEBUG_CSS_LOADS

Der Wert von Argument ist die Basisposition (im Speicheradressenbereich des Ziels) des Modulimages, für das das Modul Symbole geladen hat.

DEBUG_CSS_UNLOADS

Der Wert von Argument ist der Basisspeicherort (im Speicheradressenbereich des Ziels) des Modulbilds, für das das Modul entladene Symbole ausgibt. Wenn das Modul symbole für mehrere Bilder entladen hat, ist der Wert von Argument Null.

DEBUG_CSS_SCOPE

Der Wert Argument ist Null.

DEBUG_CSS_PATHS

Der Wert Argument ist Null.

DEBUG_CSS_SYMBOL_OPTIONS

Der Wert Argument ist die Symboloptionen.

DEBUG_CSS_TYPE_OPTIONS

Der Wert Argument ist Null.

Rückgabewert

Der Rückgabewert wird vom Modul ignoriert, es sei denn, er gibt einen Remoteprozeduraufruffehler an; in diesem Fall ist der Client, mit dem dieses IDebugEventCallbacksWide-Objekt registriert ist, deaktiviert.

Bemerkungen

Diese Methode wird nur vom Modul aufgerufen, wenn das DEBUG_EVENT_CHANGE_SYMBOL_STATE Flag in der Maske festgelegt wird, die von IDebugEventCallbacksWide::GetInterestMaskzurückgegeben wird.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Monitoring Events.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- dbgeng.h (include Dbgeng.h)