IDebugSymbols::SetSymbolOptions-Methode (dbgeng.h)

Artikel
02/26/2024

Die SetSymbolOptions-Methode ändert die globalen Symboloptionen der Engine.

Syntax

HRESULT SetSymbolOptions(
  [in] ULONG Options
);

Parameter

[in] Options

Gibt die neuen Symboloptionen an. Optionen ist ein Bitsatz; Sie ersetzt die vorhandenen Symboloptionen. Eine Beschreibung der Bitflags finden Sie unter Festlegen von Symboloptionen.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Mit dieser Methode werden die globalen Symboloptionen der Engine auf die unter Optionen angegebenen Optionen festgelegt. Im Gegensatz zu AddSymbolOptions werden alle Symboloptionen, die nicht in den Bitsatzoptionen enthalten sind, entfernt.

Nachdem die Symboloptionen geändert wurden, sendet die Engine für jeden Client eine Benachrichtigung an die IDebugEventCallbacks dieses Clients, indem das flag DEBUG_CES_SYMBOL_OPTIONS an die IDebugEventCallbacks::ChangeSymbolState-Methode übergeben wird.

Weitere Informationen zu Symbolen finden Sie unter Symbole.