IDebugAdvanced2::Request メソッド

Request メソッドは、さまざまな異なる操作を実行します。

構文

HRESULT Request(
  [in]            ULONG  Request,
  [in, optional]  PVOID  InBuffer,
  [in]            ULONG  InBufferSize,
  [out, optional] PVOID  OutBuffer,
  [in]            ULONG  OutBufferSize,
  [out, optional] PULONG OutSize
);

パラメーター

リクエスト[入力]
実行する操作を指定します。 リクエストには、次の表の値のいずれかを指定できます。 各操作の詳細は「リクエスト」欄のリンクからご確認いただけます。

要求 アクション

DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER

ソースサーバーのソースパスを確認してください。

DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT

ユーザー モード ミニダンプ ファイルに保存されたイベントのスレッド コンテキストを返します。

DEBUG_REQUEST_TARGET_EXCEPTION_THREAD

ユーザー モード ミニダンプ ファイルに保存されたイベントのオペレーティング システム スレッド ID を返します。

DEBUG_REQUEST_TARGET_EXCEPTION_RECORD

ユーザーモードのミニダンプ ファイルに保存されたイベントの例外レコードを返します。

DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS

デフォルトのプロセス作成オプションを返します。

DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS

デフォルトのプロセス作成オプションを設定します。

DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS

ターゲット上で現在実行されている Windows のバージョンを返します。

DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM

ユーザーモードのミニダンプ ターゲットからストリームを読み取ります。

DEBUG_REQUEST_TARGET_CAN_DETACH

デバッガー エンジンが現在のプロセスから切り離される (プロセスは実行されたままにするが、デバッグは行われない) ことが可能かどうかを確認します。

DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE

デバッガー エンジンの暗黙的なコマンド ラインを設定します。

DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET

現在のイベントの命令ポインタを返します。

DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM

現在のイベントの命令ポインタで最大 64 バイトのメモリを返します。

DEBUG_REQUEST_EXT_TYPED_DATA_ANSI

型指定されたデータの解釈を支援するさまざまな操作を実行します。

InBuffer [入力、オプション]
このメソッドへの入力を指定します。 入力のタイプと解釈は、Request パラメーターによって異なります。

InBufferSize [インチ]
入力バッファInBufferのサイズを指定します。 リクエストに入力が必要ない場合は、InBufferSize をゼロに設定する必要があります。

OutBuffer [出力、オプション]
このメソッドからの出力を受け取ります。 出力のタイプと解釈は、Request パラメーターによって異なります。 OutBufferNULL の場合、出力は返されません。

OutBufferSize [インチ]
出力バッファのサイズ OutBufferSize を指定します。 OutBuffer に返される出力の型のサイズが既知である場合、OutBuffer NULL に設定されている場合でも、OutBufferSize は通常、そのサイズとまったく同じであることが期待されます。

OutSize [アウト、オプション]
出力バッファ OutBuffer で返される出力のサイズを受け取ります。 OutSizeNULL の場合、この情報は返されません。

戻り値

戻り値の解釈は、Request パラメーターの値によって異なります。 特に明記されていない限り、次の値が返される場合があります。

リターン コード 説明
S_OK

この方法は成功しました。

S_FALSE

この方法は成功しました。 ただし、出力は出力バッファ OutBuffer に収まらないため、切り詰められた出力が返されました。

E_INVALIDARG

入力バッファー InBufferSize または出力バッファー OutBufferSize のサイズが予期された値ではありませんでした。

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

要件

対象プラットフォーム

デスクトップ

ヘッダー

Dbgeng.h (include Dbgeng.h)

関連項目

IDebugAdvanced2

IDebugAdvanced3

DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER

DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT

DEBUG_REQUEST_TARGET_EXCEPTION_THREAD

DEBUG_REQUEST_TARGET_EXCEPTION_RECORD

DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS

DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS

DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS

DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM

DEBUG_REQUEST_TARGET_CAN_DETACH

DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE

DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET

DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM