Metode IDebugClient5::AttachProcess (dbgeng.h)

Artikel
08/07/2023

Metode AttachProcess menghubungkan mesin debugger ke proses mode pengguna.

Sintaks

HRESULT AttachProcess(
  [in] ULONG64 Server,
  [in] ULONG   ProcessId,
  [in] ULONG   AttachFlags
);

Parameter

[in] Server

Menentukan server proses yang akan digunakan untuk melampirkan ke proses. Jika Server nol, mesin akan terhubung ke proses lokal tanpa menggunakan server proses.

[in] ProcessId

Menentukan ID proses dari proses target yang akan dilampirkan oleh debugger.

[in] AttachFlags

Menentukan bendera yang mengontrol bagaimana debugger dilampirkan ke proses target. Untuk detail tentang bendera ini, lihat Keterangan.

Nilai kembali

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Metode ini hanya tersedia untuk penelusuran kesalahan mode pengguna langsung.

Catatan Mesin tidak sepenuhnya melekat pada proses sampai metode WaitForEvent telah dipanggil. Hanya setelah proses menghasilkan peristiwa -- misalnya, peristiwa buat-proses -- apakah itu tersedia di sesi debugger.

Untuk informasi selengkapnya tentang membuat dan melampirkan ke target mode pengguna langsung, lihat Target User-Mode Langsung.

Bendera bit DEBUG_ATTACH_XXX mengontrol bagaimana mesin debugger dilampirkan ke proses mode pengguna. Untuk opsi DEBUG_ATTACH_XXX yang digunakan saat melampirkan ke target kernel, lihat AttachKernel.

Tabel berikut ini menjelaskan kemungkinan nilai bendera.

Terus-menerus	Deskripsi
DEBUG_ATTACH_NONINVASIVE	Lampirkan ke target secara noninvasif. Untuk informasi selengkapnya tentang penelusuran kesalahan noninvasif, lihat Penelusuran Kesalahan Noninvasif (Mode Pengguna). Jika bendera ini diatur, maka bendera DEBUG_ATTACH_EXISTING, DEBUG_ATTACH_INVASIVE_NO_INITIAL_BREAK, dan DEBUG_ATTACH_INVASIVE_RESUME_PROCESS tidak boleh diatur.
DEBUG_ATTACH_EXISTING	Lampirkan kembali ke aplikasi yang telah dilampirkan debugger (dan mungkin ditinggalkan). Untuk informasi selengkapnya tentang melampirkan kembali ke target, lihat Melampirkan kembali ke Aplikasi Target. Jika bendera ini diatur, maka bendera DEBUG_ATTACH_XXX lainnya tidak boleh diatur.
DEBUG_ATTACH_NONINVASIVE_NO_SUSPEND	Jangan menangguhkan utas target saat melampirkan secara noninvasif. Jika bendera ini diatur, maka bendera DEBUG_ATTACH_NONINVASIVE juga harus diatur.
DEBUG_ATTACH_INVASIVE_NO_INITIAL_BREAK	(Windows XP dan yang lebih baru) Jangan meminta pembobolan awal saat melampirkan ke target. Jika bendera ini diatur, maka bendera DEBUG_ATTACH_NONINVASIVE dan DEBUG_ATTACH_EXISTING tidak boleh diatur.
DEBUG_ATTACH_INVASIVE_RESUME_PROCESS	Jika bendera ini diatur, maka bendera DEBUG_ATTACH_NONINVASIVE dan DEBUG_ATTACH_EXISTING tidak boleh diatur.