IDebugAdvanced3::Request メソッド (dbgeng.h)

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

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

構文

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

パラメーター

[in] Request

実行する操作を指定します。要求には、次の表のいずれかの値を指定できます。各操作の詳細は、[要求] 列のリンクに従って確認できます。

要求	アクション
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	型指定されたデータの解釈に役立つさまざまな操作を実行します。

[in, optional] InBuffer

このメソッドへの入力を指定します。入力の型と解釈は 、Request パラメーターによって異なります。

[in] InBufferSize

入力バッファー InBuffer のサイズを指定します。要求に入力が必要ない場合は、 InBufferSize を 0 に設定する必要があります。

[out, optional] OutBuffer

このメソッドから出力を受け取ります。出力の型と解釈は 、Request パラメーターによって異なります。 OutBuffer が NULL の場合、出力は返されません。

[in] OutBufferSize

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

[out, optional] OutSize

出力バッファー OutBuffer で返される出力のサイズを受け取ります。 OutSize が NULL の場合、この情報は返されません。

戻り値

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

リターンコード	説明
S_OK	メソッドは正常に実行されました。
S_FALSE	メソッドは正常に実行されました。ただし、出力は出力バッファー OutBuffer に収まらないため、切り捨てられた出力が返されました。
E_INVALIDARG	入力バッファー InBufferSize のサイズ、または出力バッファーの OutBufferSize のサイズが予期した値ではありません。