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

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

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

構文

HRESULT SetSymbolOptions(
  [in] ULONG Options
);

パラメーター

[in] Options

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

戻り値

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

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

注釈

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

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

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