IDebugSymbols::SetSymbolOptions メソッド (dbgeng.h)

[アーティクル]
02/26/2024

SetSymbolOptions メソッドは、エンジンのグローバルシンボルオプションを変更します。

構文

HRESULT SetSymbolOptions(
  [in] ULONG Options
);

パラメーター

[in] Options

新しいシンボルオプションを指定します。 オプション はビットセットです。既存のシンボルオプションが置き換えられます。ビットフラグの説明については、「シンボルオプションの設定」を参照してください。

戻り値

このメソッドは、エラー値を返す場合もあります。詳細については、「戻り値」を参照してください。

リターンコード	説明
S_OK	メソッドは正常に実行されました。

注釈

このメソッドは、エンジンのグローバルシンボルオプションを [オプション]で指定したオプションに設定します。 AddSymbolOptions とは異なり、ビットセットオプションに含まれていないシンボル オプションはすべて削除されます。

シンボルオプションが変更された後、各クライアントに対して、エンジンは IDebugEventCallbacks ::ChangeSymbolState メソッドにDEBUG_CES_SYMBOL_OPTIONS フラグを渡すことによって、そのクライアントの IDebugEventCallbacks に通知を送信します。

シンボルの詳細については、「シンボル」を参照してください。