IDebugAdvanced2：：Request 方法

發行項
02/07/2024

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]
指定要執行的作業。要求可以是下表中的其中一個值。您可以遵循 [要求] 資料行中的連結，找到每個作業的詳細數據。

要求	動作
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	執行各種不同的作業，以協助解譯具型別的數據。

InBuffer [in ， optional]
指定這個方法的輸入。輸入的類型和解譯取決於 Request 參數。

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

OutBuffer [out， optional]
接收這個方法的輸出。輸出的類型和解譯取決於 Request 參數。如果 OutBuffer 為 NULL，則不會傳回輸出。

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

OutSize [out ，選擇性]
接收輸出緩衝區 OutBuffer 中傳回的輸出大小。如果 OutSize 為 NULL，則不會傳回這項資訊。

傳回值

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

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