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.