IDebugAdvanced2：：Request 方法（dbgeng.h）

發行項
02/06/2025

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	傳回使用者模式迷你傾印檔案中預存事件的作系統線程標識碼。
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

指定這個方法的輸入。輸入的類型和解譯取決於要求參數。

[in] InBufferSize

指定輸入緩衝區的大小，InBuffer。如果要求不需要輸入，InBufferSize 應設定為零。

[out, optional] OutBuffer

從這個方法接收輸出。輸出的類型和解譯取決於要求參數。如果 outBuffer NULL，則不會傳回輸出。

[in] OutBufferSize

指定輸出緩衝區的大小，OutBufferSize。如果傳回給 outBuffer 的輸出類型具有已知的大小，OutBufferSize 通常預期為該大小，即使 OutBuffer 設定為 NULL也是如此。

[out, optional] OutSize

接收輸出緩衝區中傳回的輸出大小，OutBuffer。如果 OutSizeNULL，則不會傳回此資訊。

傳回值

傳回值的解譯取決於 Request 參數的值。除非另有說明，否則可能會傳回下列值。

傳回碼	描述
S_OK	方法成功。
S_FALSE	方法成功。不過，輸出不適用於輸出緩衝區 OutBuffer，因此會傳回截斷的輸出。
E_INVALIDARG	輸入緩衝區的大小 InBufferSize 或輸出緩衝區的大小 OutBufferSize 不是預期的值。