CreateDebuggingInterfaceFromVersion3-Funktion

Artikel
03/12/2024

Akzeptiert eine Versionszeichenfolge der Common Language Runtime (CLR), die von der CreateVersionStringFromModule-Funktion zurückgegeben wird, und gibt eine entsprechende Debugschnittstelle zurück (normalerweise ICorDebug).

Syntax

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

Parameter

iDebuggerVersion
[in] Die Version der Schnittstelle, die der Debugger erwartet.

szDebuggeeVersion
[in] Versionszeichenfolge der CLR in der zu debuggenden Zielkomponente, die von der CreateVersionStringFromModule-Funktion zurückgegeben wird.

szApplicationGroupId
[in] Eine Zeichenfolge, die die Anwendungsgruppen-ID eines Sandboxprozesses darstellt, der in macOS ausgeführt wird. Übergeben Sie NULL, wenn der Prozess unter macOS nicht in einer Sandbox oder auf anderen Plattformen ausgeführt wird.

pLibraryProvider
[in] Eine Rückrufschnittstelleninstanz zum Suchen von DBI und DAC. Weitere Informationen finden Sie in der ICLRDebuggingLibraryProvider3-Schnittstelle.

ppCordb
Zeiger auf einen Zeiger auf ein COM-Objekt (IUnknown). Dieses Objekt wird in ein ICorDebug-Objekt umgewandelt, bevor es zurückgegeben wird.

Rückgabewert

S_OK
ppCordb verweist auf ein gültiges Objekt, das die ICorDebug-Schnittstelle implementiert.

E_INVALIDARG
Entweder szDebuggeeVersion oder ppCordb ist null.

CORDBG_E_DEBUG_COMPONENT_MISSING
Eine für das CLR-Debuggen erforderliche Komponente kann nicht gefunden werden. Entweder mscordbi.dll oder mscordaccore.dll wurde nicht im selben Verzeichnis wie die betreffende CoreCLR.dll gefunden.

CORDBG_E_INCOMPATIBLE_PROTOCOL
Entweder mscordbi.dll oder mscordaccore.dll haben nicht dieselbe Version wie die Ziel-CoreCLR.dll.

E_FAIL (oder andere E_-Rückgabecodes)
Eine ICorDebug-Schnittstelle kann nicht zurückgegeben werden.

Bemerkungen

Die zurückgegebene Schnittstelle stellt die Funktionen zum Anfügen an eine CLR in einem Zielprozess und zum Debuggen von verwaltetem Code bereit, der von der CLR ausgeführt wird.

Anforderungen

Plattformen: Siehe Von .NET unterstützte Betriebssysteme.

Header: dbgshim.h

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

.NET-Versionen: Verfügbar seit .NET 6.0.

Teilen über