IDebugAdvanced3::Metode permintaan (dbgeng.h)

Artikel
03/08/2023

Metode Permintaan melakukan berbagai operasi yang berbeda.

Sintaks

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

Parameter

[in] Request

Menentukan operasi mana yang akan dilakukan. Permintaan bisa menjadi salah satu nilai dalam tabel berikut. Detail setiap operasi dapat ditemukan dengan mengikuti tautan di kolom "Permintaan".

Minta	Tindakan
DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER	Periksa jalur sumber untuk server sumber.
DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT	Mengembalikan konteks utas untuk peristiwa yang disimpan dalam file minidump mode pengguna.
DEBUG_REQUEST_TARGET_EXCEPTION_THREAD	Mengembalikan ID utas sistem operasi untuk peristiwa tersimpan dalam file minidump mode pengguna.
DEBUG_REQUEST_TARGET_EXCEPTION_RECORD	Mengembalikan rekaman pengecualian untuk peristiwa yang disimpan dalam file minidump mode pengguna.
DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS	Mengembalikan opsi pembuatan proses default.
DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS	Atur opsi pembuatan proses default.
DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS	Mengembalikan versi Windows yang saat ini berjalan pada target.
DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM	Membaca aliran dari target minidump mode pengguna.
DEBUG_REQUEST_TARGET_CAN_DETACH	Periksa untuk melihat apakah mesin debugger dapat terlepas dari proses saat ini (membiarkan proses berjalan tetapi tidak lagi di-debug).
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE	Atur baris perintah implisit mesin debugger.
DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET	Mengembalikan penunjuk instruksi peristiwa saat ini.
DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM	Kembalikan memori hingga 64 byte pada penunjuk instruksi peristiwa saat ini.
DEBUG_REQUEST_EXT_TYPED_DATA_ANSI	Lakukan berbagai operasi berbeda yang membantu dalam interpretasi data yang di ketik.

[in, optional] InBuffer

Menentukan input ke metode ini. Jenis dan interpretasi input tergantung pada parameter Permintaan .

[in] InBufferSize

Menentukan ukuran buffer input InBuffer. Jika permintaan tidak memerlukan input, InBufferSize harus diatur ke nol.

[out, optional] OutBuffer

Menerima output dari metode ini. Jenis dan interpretasi output tergantung pada parameter Permintaan . Jika OutBufferNULL, output tidak dikembalikan.

[in] OutBufferSize

Menentukan ukuran buffer output OutBufferSize. Jika jenis output yang dikembalikan ke OutBuffer memiliki ukuran yang diketahui, OutBufferSize biasanya diharapkan sama persis dengan ukuran tersebut, bahkan jika OutBuffer diatur ke NULL.

[out, optional] OutSize

Menerima ukuran output yang dikembalikan dalam buffer output OutBuffer. Jika OutSizeNULL, informasi ini tidak dikembalikan.

Nilai kembali

Interpretasi nilai yang dikembalikan tergantung pada nilai parameter Permintaan . Kecuali dinyatakan lain, nilai berikut dapat dikembalikan.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
S_FALSE	Metode berhasil. Namun, output tidak akan pas dalam buffer output OutBuffer, sehingga output terpotong dikembalikan.
E_INVALIDARG	Ukuran buffer input InBufferSize atau ukuran buffer output OutBufferSize bukanlah nilai yang diharapkan.