Fungsi CreateDebuggingInterfaceFromVersion3

Menerima string versi runtime bahasa umum (CLR) yang dikembalikan dari fungsi CreateVersionStringFromModule , dan mengembalikan antarmuka debugger yang sesuai (biasanya, ICorDebug).

Sintaksis

HRESULT CreateDebuggingInterfaceFromVersion3 (
    [in] int iDebuggerVersion,
    [in] LPCWSTR szDebuggeeVersion,
    [in] LPCWSTR szApplicationGroupId,
    [in] ICLRDebuggingLibraryProvider3* pLibraryProvider,
    [out] IUnknown** ppCordb,
);

Parameter-parameternya

iDebuggerVersion
[di] Versi antarmuka yang diharapkan debugger.

szDebuggeeVersion
[di] String versi CLR dalam debuggee target, yang dikembalikan oleh fungsi CreateVersionStringFromModule .

szApplicationGroupId
[di] String yang mewakili ID grup aplikasi dari proses terkotakpasir yang berjalan di macOS. Berikan NULL jika proses tidak berjalan di kotak pasir di macOS atau di platform lain.

pLibraryProvider
[di] Instans antarmuka panggilan balik untuk menemukan DBI dan DAC. Lihat Antarmuka ICLRDebuggingLibraryProvider3 .

ppCordb
[out] Penunjuk ke penunjuk ke objek COM (IUnknown). Objek ini akan ditransmisikan ke objek ICorDebug sebelum dikembalikan.

Mengembalikan nilai

S_OK
ppCordb mereferensikan objek valid yang mengimplementasikan antarmuka antarmuka ICorDebug .

E_INVALIDARG
Baik szDebuggeeVersion atau ppCordb null.

CORDBG_E_DEBUG_COMPONENT_MISSING
Komponen yang diperlukan untuk penelusuran kesalahan CLR tidak dapat ditemukan. Baik mscordbi.dll atau mscordaccore.dll tidak ditemukan di direktori yang sama dengan target CoreCLR.dll.

CORDBG_E_INCOMPATIBLE_PROTOCOL
Baik mscordbi.dll atau mscordaccore.dll bukan versi yang sama dengan target CoreCLR.dll.

E_FAIL (atau kode pengembalian lainnya E_ )
Tidak dapat mengembalikan antarmuka ICorDebug.

Komentar

Antarmuka yang dikembalikan menyediakan fasilitas untuk melampirkan ke CLR dalam proses target dan men-debug kode terkelola yang dijalankan CLR.

Persyaratan

Platform: Lihat Sistem operasi yang didukung .NET.

Header: dbgshim.h

Pustaka: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Versi .NET: Tersedia sejak .NET 6.0