IDebugSymbols2::SetSymbolOptions-Methode (dbgeng.h)

Artikel
02/23/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 kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

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

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

Weitere Informationen zu Symbolen finden Sie unter Symbole.