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

[アーティクル]
08/07/2023

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

構文

HRESULT SetEngineOptions(
  [in] ULONG Options
);

パラメーター

[in] Options

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

戻り値

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

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

注釈

このメソッドは、エンジンのオプションを [オプション] で指定したオプションに設定します。 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	Quiet モードをオンにします。詳細については、「 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) データのアップロードを無効にします。