De functie CreateDebuggingInterfaceFromVersion3

Accepteert een common Language Runtime-versietekenreeks (CLR) die wordt geretourneerd door de functie CreateVersionStringFromModule en retourneert een bijbehorende foutopsporingsprogramma-interface (meestal ICorDebug).

Syntaxis

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

Parameterwaarden

iDebuggerVersion
[in] De versie van de interface die het foutopsporingsprogramma verwacht.

szDebuggeeVersion
[in] Versietekenreeks van de CLR in de doelfoutopsporing, die wordt geretourneerd door de functie CreateVersionStringFromModule .

szApplicationGroupId
[in] Een tekenreeks die de groeps-id van de toepassing vertegenwoordigt van een sandboxproces dat wordt uitgevoerd in macOS. Geef NULL door als het proces niet wordt uitgevoerd in een sandbox op macOS of op andere platforms.

pLibraryProvider
[in] Een callback-interface-exemplaar voor het vinden van DBI en DAC. Zie de interface ICLRDebuggingLibraryProvider3 .

ppCordb
[uit] Aanwijzer naar een aanwijzer naar een COM-object (IUnknown). Dit object wordt gecast naar een ICorDebug-object voordat het wordt geretourneerd.

Retourwaarde

S_OK
ppCordb verwijst naar een geldig object dat de interface van de ICorDebug-interface implementeert.

E_INVALIDARG
szDebuggeeVersion Of ppCordb is null.

CORDBG_E_DEBUG_COMPONENT_MISSING
Een onderdeel dat nodig is voor CLR-foutopsporing, kan zich niet bevinden. mscordbi.dllof mscordaccore.dll is niet gevonden in dezelfde map als de doel-CoreCLR.dll.

CORDBG_E_INCOMPATIBLE_PROTOCOL
Zowel mscordbi.dll als mscordaccore.dll is niet dezelfde versie als de doelversie CoreCLR.dll.

E_FAIL (of andere E_ retourcodes)
Kan geen ICorDebug-interface retourneren.

Opmerkingen

De interface die wordt geretourneerd, biedt de faciliteiten voor het koppelen aan een CLR in een doelproces en het opsporen van fouten in de beheerde code die door de CLR wordt uitgevoerd.

Behoeften

Platformen: Zie ondersteunde besturingssystemen van .NET.

Koptekst: dbgshim.h

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

.NET-versies: Beschikbaar sinds .NET 6.0