"CreateDebuggingInterfaceFromVersion"-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 CreateDebuggingInterfaceFromVersion (
    [in]  LPCWSTR      szDebuggeeVersion,
    [out] IUnknown**   ppCordb,
);

Die Parameter

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

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 Core 2.1