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

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

GetExceptionFilterSecondCommand メソッドは、指定された例外が 2 回目に発生したときにデバッガーエンジンによって実行されるコマンドを返します。

構文

HRESULT GetExceptionFilterSecondCommand(
  [in]            ULONG  Index,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG CommandSize
);

パラメーター

[in] Index

second-chance コマンドが返される例外フィルターのインデックスを指定します。 また、インデックス は既定の例外フィルターを参照して、特定の例外フィルターまたは任意の例外フィルターを持たない例外に対して second-chance コマンドを返すこともできます。

[out, optional] Buffer

例外フィルターの second-chance コマンドを受け取ります。

[in] BufferSize

Buffer が指定するバッファーのサイズを文字数で指定します。このサイズには、'\0' 終端文字のスペースが含まれます。

[out, optional] CommandSize

例外フィルターの second-chance コマンドのサイズを文字単位で受け取ります。このサイズには、'\0' 終端文字のスペースが含まれます。 CommandSize が NULL の場合、この情報は返されません。

戻り値

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

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

注釈

例外フィルターのみが second-chance コマンドをサポートします。 Index が特定のイベントフィルターを参照している場合、Buffer に返されるコマンドは空になります。指定した例外に対して second-chance コマンドが設定されていない場合、返されるコマンドも空になります。

イベントフィルターの詳細については、「イベントフィルター」を参照してください。