Freigeben über


CreateDebuggingInterfaceFromVersion-Funktion (.NET Framework)

Erstellt ein ICorDebug-Objekt anhand der angegebenen Versionsinformationen.

Diese Funktion ist in .NET Framework 4 veraltet. Verwenden Sie stattdessen zum Abrufen einer Schnittstelle für die Common Language Runtime (CLR) 2.0 die ICLRRuntimeInfo::GetInterface-Methode, und geben Sie den Klassenbezeichner CLSID_CLRDebuggingLegacy und den Schnittstellenbezeichner IID_ICorDebug an. Um eine Schnittstelle für CLR 4 oder höher abzurufen, rufen Sie die CLRCreateInstance-Funktion auf, und geben Sie den Klassenbezeichner CLSID_CLRDebugging und den Schnittstellenbezeichner IID_ICLRDebugging an.

Syntax

HRESULT CreateDebuggingInterfaceFromVersion (
    [in]  int      iDebuggerVersion,
    [in]  LPCWSTR  szDebuggeeVersion,
    [out] IUnknown **ppCordb
);

Parameter

iDebuggerVersion
[in] Die Version von ICorDebug, die vom Debugger erwartet wird. Gültige Werte finden Sie in der CorDebugInterfaceVersion-Enumeration.

szDebuggeeVersion
[in] Die Common Language Runtime-Version, die der zu debuggenden Anwendung oder dem zu debuggenden Prozess zugeordnet ist. Informationen zum Abrufen dieses Werts finden Sie unter getVersionFromProcess oder der GetRequestedRuntimeVersion-Methode.

ppCordb
[out] Die Position, die einen Zeiger auf das ICorDebug-Objekt empfängt.

Rückgabewert

Diese Methode gibt zusätzlich zu den folgenden Werten die COM-Standardfehlercodes zurück, wie sie in der Datei „WinError.h“ definiert sind.

Rückgabecode Beschreibung
S_OK Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG szDebuggeeVersion oder ppCordb ist NULL, oder die Versionszeichenfolge ist falsch.

Bemerkungen

Der Parameter szDebuggeeVersion wird der entsprechenden Version von MSCorDbi.dll zugeordnet.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: MSCorEE.dll

.NET Framework-Versionen: Seit 2.0 verfügbar.

Siehe auch