IDebugControl3::SetEngineOptions メソッド (dbgeng.h)

[アーティクル]
02/06/2025

SetEngineOptions メソッドは、エンジンのオプションを変更します。

構文

HRESULT SetEngineOptions(
  [in] ULONG Options
);

パラメーター

[in] Options

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

戻り値

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

リターンコード	形容
S_OK	メソッドが成功しました。

備考

このメソッドは、エンジンのオプションを Optionsで指定されたオプションに設定します。 AddEngineOptionsとは異なり、[オプション] ビットセットに表示されていないシンボルオプションは削除されます。

エンジンオプションが変更されると、DEBUG_CES_ENGINE_OPTIONS フラグを IDebugEventCallbacks::ChangeEngineState メソッドに渡すことによって、各クライアントのイベントコールバックオブジェクトに通知が送信されます。

次のグローバルオプションは、デバッガーエンジンのの動作に影響します。

定数	形容
DEBUG_ENGOPT_IGNORE_DBGHELP_VERSION	デバッガーエンジンのバージョンがデバッガーエンジンのバージョンと一致しない場合、デバッガーエンジンはエラーではなく警告を生成します。
DEBUG_ENGOPT_IGNORE_EXTENSION_VERSIONS	拡張機能のバージョンチェックを無効にします。これにより、CheckVersionへのデバッガーエンジンの呼び出しが抑制されます。
DEBUG_ENGOPT_ALLOW_NETWORK_PATHS	ネットワーク共有は、シンボルと拡張機能の読み込みに使用できます。このオプションは、一部のシステムプロセスをデバッグするときにエンジンがネットワークパスを禁止することを防ぎ、慎重に使用する必要があります。 DEBUG_ENGOPT_DISALLOW_NETWORK_PATHSが設定されている場合、このオプションは設定できません。
DEBUG_ENGOPT_DISALLOW_NETWORK_PATHS	シンボルと拡張機能の読み込みにネットワーク共有を使用することはできません。エンジンは、一部のシステムプロセスをデバッグするときに、このオプションの設定を試みます。 DEBUG_ENGOPT_ALLOW_NETWORK_PATHSが設定されている場合、このオプションは設定できません。
DEBUG_ENGOPT_NETWORK_PATHS	DEBUG_ENGOPT_ALLOW_NETWORK_PATHSとDEBUG_ENGOPT_DISALLOW_NETWORK_PATHSのビットごとの OR。
DEBUG_ENGOPT_IGNORE_LOADER_EXCEPTIONS	特定のバージョンの Windows でローダーによって生成される予期される初回例外を無視します。たとえば、このオプションを使用すると、Windows 3.1 および 3.5 システムをデバッグするときに Windows 3.51 バイナリを実行できます。
DEBUG_ENGOPT_INITIAL_BREAK	ターゲットの初期イベントでデバッガーに分割します。
DEBUG_ENGOPT_INITIAL_MODULE_BREAK	ターゲットが最初のモジュールを読み込むと、デバッガーに中断します。
DEBUG_ENGOPT_FINAL_BREAK	ターゲットの最後のイベントでデバッガーに分割します。ライブユーザーモードターゲットでは、プロセスが終了します。カーネルモードでは効果がありません。
DEBUG_ENGOPT_NO_EXECUTE_REPEAT	空のコマンドが指定された場合、デバッガーエンジンは最後のコマンドを繰り返しません。
DEBUG_ENGOPT_FAIL_INCOMPLETE_INFORMATION	イメージをマップできないモジュールをデバッガーが読み込むのを防ぎます。デバッガーは、イメージが含まれていないミニダンプをデバッグするときに、イメージの読み込みを試みます。
DEBUG_ENGOPT_ALLOW_READ_ONLY_BREAKPOINTS	デバッガーエンジンがターゲットのページ保護を操作して、メモリの読み取り専用セクションにソフトウェアブレークポイントを設定できるようにします。ソフトウェアブレークポイントを設定すると、エンジンは割り込み命令を挿入するようにターゲットのメモリを透過的に変更します。
DEBUG_ENGOPT_SYNCHRONIZE_BREAKPOINTS	ライブユーザーモードデバッグでは、ブレークポイントの挿入と削除時にエンジンが追加の作業を実行して、ターゲットにされているすべてのスレッドが常に一貫したブレークポイント状態になるようにします。このオプションは、ブレークポイントが設定されているコードを複数のスレッドが使用できる場合に便利です。ただし、デッドロックの可能性が生じる可能性があります。
DEBUG_ENGOPT_DISALLOW_SHELL_COMMANDS	デバッガーによるシェルコマンドの実行を禁止します。このオプションを設定した後は、設定を解除できません。
DEBUG_ENGOPT_KD_QUIET_MODE	静音モードをオンにします。詳細については、「sq (Set Quiet Mode)」を参照してください。
DEBUG_ENGOPT_DISABLE_MANAGED_SUPPORT	マネージドコードに対するデバッガーエンジンのサポートを無効にします。マネージドコードのサポートが既に使用されている場合、このオプションは無効です。
DEBUG_ENGOPT_DISABLE_MODULE_SYMBOL_LOAD	デバッガーでは、このフラグが設定されている間に読み込まれるモジュールのシンボルは読み込まれません。
DEBUG_ENGOPT_DISABLE_EXECUTION_COMMANDS	ターゲットの実行を開始するコマンドを禁止します。
DEBUG_ENGOPT_DISALLOW_IMAGE_FILE_MAPPING	ディスクからのイメージファイルのマッピングを禁止します。たとえば、このオプションは、ミニダンプファイルのデバッグ中にメモリコンテンツのイメージマッピングを禁止します。このオプションは、既存のマッピングには影響しません。これは、イメージファイルをマップする後続の試行にのみ影響します。
DEBUG_ENGOPT_PREFER_DML	デバッガーは、既定で DML 拡張バージョンのコマンドと操作を実行します。
DEBUG_ENGOPT_DISABLESQM	ソフトウェア品質メトリック (SQM) データのアップロードを無効にします。

必要条件

要件	価値
ターゲットプラットフォームの	デスクトップ
ヘッダー	dbgeng.h (Dbgeng.h を含む)

次の方法で共有

IDebugControl3::SetEngineOptions メソッド (dbgeng.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース