CreateDebuggingInterfaceFromVersion-Funktion

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

Parameter

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

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

Teilen über