CreateDebuggingInterfaceFromVersion3-Funktion

Akzeptiert eine ClR-Versionszeichenfolge (Common Language Runtime), die von der CreateVersionStringFromModule-Funktion zurückgegeben wird, und gibt eine entsprechende Debuggerschnittstelle (in der Regel ICorDebug) zurück.

Syntax

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

Die Parameter

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

szDebuggeeVersion
[in] Versionszeichenfolge der CLR im Zieldebuggee, die von der CreateVersionStringFromModule-Funktion zurückgegeben wird.

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

pLibraryProvider
[in] Eine Rückrufschnittstelleninstanz zum Suchen von DBI und DAC. Siehe ICLRDebuggingLibraryProvider3-Schnittstelle .

ppCordb
[out] 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-Schnittstellenschnittstelle implementiert.

E_INVALIDARG
Entweder szDebuggeeVersion oder ppCordb ist NULL.

CORDBG_E_DEBUG_COMPONENT_MISSING
Eine Komponente, die für das CLR-Debugging erforderlich ist, kann nicht gefunden werden. Entweder mscordbi.dll oder mscordaccore.dll wurde im selben Verzeichnis wie das Ziel CoreCLR.dllnicht gefunden.

CORDBG_E_INCOMPATIBLE_PROTOCOL
Entweder mscordbi.dll oder mscordaccore.dll ist nicht die gleiche Version wie das 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 Möglichkeiten zum Anfügen an eine CLR in einem Zielprozess bereit und debuggen den verwalteten Code, den die CLR ausführt.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Header: dbgshim.h

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

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