Fungsi DebugConnect (dbgeng.h)

  • Artikel

Fungsi DebugConnect dan DebugConnectWide membuat objek klien baru dan mengembalikan penunjuk antarmuka ke objek tersebut. Objek klien akan terhubung ke host jarak jauh.

Sintaks

HRESULT DebugConnect(
  [in]  PCSTR  RemoteOptions,
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

Parameter

[in] RemoteOptions

Menentukan bagaimana mesin debugger akan terhubung ke host jarak jauh. Ini adalah opsi yang sama yang diteruskan ke opsi -remote pada baris perintah. Untuk detail tentang sintaks string ini, lihat Mengaktifkan Klien Debugging.

[in] InterfaceId

Menentukan pengidentifikasi antarmuka (IID) dari antarmuka klien mesin debugger yang diinginkan. Ini adalah jenis antarmuka yang akan dikembalikan dalam Antarmuka. Untuk informasi tentang pengidentifikasi antarmuka, lihat Menggunakan Objek Klien.

[out] Interface

Menerima penunjuk antarmuka untuk klien baru. Jenis antarmuka ini ditentukan oleh InterfaceId.

Menampilkan nilai

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

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.

Keterangan

Seperti halnya IUnknown::QueryInterface, ketika antarmuka yang dikembalikan tidak lagi diperlukan, metode IUnknown::Release harus dipanggil.

Anda tidak perlu memanggil CoInitialize, CoInitializeEx, atau OleInitialize untuk menggunakan fungsi dan antarmuka ini yang diperoleh olehnya.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header dbgeng.h (termasuk Dbgeng.h)

Lihat juga

Objek Klien

Server Proses dan Klien Cerdas