IDebugSymbols2::SetSymbolOptions-Methode (dbgeng.h)

Artikel
02/06/2025

Die SetSymbolOptions Methode ändert die globalen Symboloptionen des Moduls.

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 Bitkennzeichnungen 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.

Bemerkungen

Diese Methode legt die globalen Symboloptionen des Moduls auf diejenigen fest, die in Optionenangegeben sind. Im Gegensatz zu AddSymbolOptionswerden alle Symboloptionen entfernt, die nicht im Bitsatz Optionen enthalten sind.

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

Weitere Informationen zu Symbolen finden Sie unter Symbole.