IDebugAdvanced3：：Request 方法 (dbgeng.h)

發行項
02/23/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] 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

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

[in] InBufferSize

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

[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 的大小不是預期的值。