Bagikan melalui


IDebugProcess2::Attach

Melampirkan manajer debug sesi (SDM) ke proses.

Sintaks

int Attach( 
   IDebugEventCallback2 pCallback,
   Guid[]               rgguidSpecificEngines,
   uint                 celtSpecificEngines,
   int[]                rghrEngineAttach
);

Parameter

pCallback
[di] Objek IDebugEventCallback2 yang digunakan untuk pemberitahuan peristiwa debug.

rgguidSpecificEngines
[di] Array GUID mesin debug yang akan digunakan untuk men-debug program yang berjalan dalam proses. Parameter ini bisa menjadi nilai null. Lihat Keterangan untuk detailnya.

celtSpecificEngines
[di] Jumlah mesin debug dalam rgguidSpecificEngines array dan ukuran rghrEngineAttach array.

rghrEngineAttach
[masuk, keluar] Array kode HRESULT yang dikembalikan oleh mesin debug. Ukuran array ini ditentukan dalam celtSpecificEngines parameter . Setiap kode biasanya baik S_OK atau S_ATTACH_DEFERRED. Yang terakhir menunjukkan bahwa DE saat ini melekat pada tidak ada program.

Tampilkan Nilai

Jika berhasil, mengembalikan S_OK; jika tidak, mengembalikan kode galat. Tabel berikut ini memperlihatkan kemungkinan nilai lainnya.

Nilai Deskripsi
E_ATTACH_DEBUGGER_ALREADY_ATTACHED Proses yang ditentukan sudah dilampirkan ke debugger.
E_ATTACH_DEBUGGEE_PROCESS_SECURITY_VIOLATION Pelanggaran keamanan terjadi selama prosedur lampiran.
E_ATTACH_CANNOT_ATTACH_TO_DESKTOP Proses desktop tidak dapat dilampirkan ke debugger.

Keterangan

Melampirkan ke proses melampirkan SDM ke semua program yang berjalan dalam proses tersebut yang dapat di-debug oleh mesin debug (DE) yang ditentukan dalam rgguidSpecificEngines array. Atur rgguidSpecificEngines parameter ke nilai null atau sertakan GUID_NULL dalam array untuk dilampirkan ke semua program dalam proses.

Semua peristiwa debug yang terjadi dalam proses dikirim ke objek IDebugEventCallback2 yang diberikan. Objek ini IDebugEventCallback2 disediakan ketika SDM memanggil metode ini.

Baca juga