Bagikan melalui

Metode ICLRDebugManager::BeginConnection

Membuat koneksi baru antara host dan debugger untuk mengaitkan daftar tugas dengan pengidentifikasi dan nama yang mudah diingat.

Sintaks

HRESULT BeginConnection (  
    [in] CONNID dwConnectionId,  
    [in, string] wchar_t* szConnectionName  
);

Parameter

dwConnectionId
[in] Pengidentifikasi untuk dikaitkan dengan daftar tugas runtime bahasa umum (CLR).

szConnectionName
[in] Nama yang mudah diingat untuk dikaitkan dengan daftar tugas runtime bahasa umum.

Tampilkan Nilai

HRESULT Deskripsi
S_OK BeginConnection berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum belum dimuat ke dalam proses, atau runtime bahasa umum dalam status yaitu tidak dapat menjalankan kode aman atau memproses panggilan dengan sukses.
HOST_E_TIMEOUT Waktu panggilan habis.
HOST_E_NOT_OWNER Pemanggil tidak memiliki kunci.
HOST_E_ABANDONED Peristiwa dibatalkan saat rangkaian atau fiber yang diblokir sedang menunggunya.
E_FAIL Terjadi kegagalan bencana yang tidak diketahui. Saat metode menampilkan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting menampilkan HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG dwConnectionId nol, atau BeginConnection sudah dipanggil menggunakan nilai dwConnectionId ini, atau szConnectionName null.
E_OUTOFMEMORY Tidak cukup memori dapat dialokasikan untuk menyimpan daftar tugas yang terkait dengan koneksi ini.

Keterangan

ICLRDebugManager menyediakan tiga metode, BeginConnection, SetConnectionTasks, dan EndConnection, untuk mengaitkan daftar tugas dengan pengidentifikasi dan nama yang mudah diingat.

Penting

Ketiga metode ini harus dipanggil dalam urutan tertentu untuk setiap rangkaian tugas. BeginConnection dipanggil terlebih dahulu untuk membuat koneksi baru. SetConnectionTasks dipanggil setelahnya untuk menyediakan serangkaian tugas yang akan dikaitkan dengan koneksi tersebut. EndConnection dipanggil terakhir untuk menghapus hubungan antara daftar tugas dan pengidentifikasi serta nama yang mudah diingat. Namun, panggilan untuk koneksi yang berbeda dapat dilapiskan.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on