Méthode IDebugSymbols3 ::SetSymbolOptions (dbgeng.h)

La méthode SetSymbolOptions modifie les options de symbole global du moteur.

Syntaxe

HRESULT SetSymbolOptions(
  [in] ULONG Options
);

Paramètres

[in] Options

Spécifie les nouvelles options de symbole. Options est un jeu de bits ; il remplacera les options de symbole existantes. Pour obtenir une description des indicateurs de bits, consultez Définition des options de symbole.

Valeur retournée

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour .

Code de retour Description
S_OK
La méthode a réussi.

Remarques

Cette méthode définit les options de symboles globaux du moteur sur celles spécifiées dans Options. Contrairement à AddSymbolOptions, toutes les options de symbole qui ne sont pas dans les options du jeu de bits seront supprimées.

Une fois les options de symbole modifiées, pour chaque client, le moteur envoie une notification aux IDebugEventCallbacks de ce client en passant l’indicateur DEBUG_CES_SYMBOL_OPTIONS à la méthode IDebugEventCallbacks ::ChangeSymbolState .

Pour plus d’informations sur les symboles, consultez Symboles.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h, Dbghelp.h)

Voir aussi

AddSymbolOptions

GetSymbolOptions

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

RemoveSymbolOptions