CreateDebuggingInterfaceFromVersion3 függvény

Elfogadja a CreateVersionStringFromModule függvényből visszaadott közös nyelvi futtatókörnyezeti (CLR) verziósztringet, és visszaad egy megfelelő hibakereső felületet (általában ICorDebug).

Szemantika

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

Paraméterek

iDebuggerVersion
[in] A hibakereső által várt felület verziója.

szDebuggeeVersion
[in] A CLR verziósztringje a célkeresésben, amelyet a CreateVersionStringFromModule függvény ad vissza.

szApplicationGroupId
[in] Egy macOS rendszerben futó tesztkörnyezeti folyamat alkalmazáscsoport-azonosítóját képviselő sztring. Adja át a NULL értéket, ha a folyamat nem futó tesztkörnyezetben macOS-en vagy más platformokon.

pLibraryProvider
[in] Visszahívási felületi példány a DBI és a DAC megkereséséhez. Lásd: ICLRDebuggingLibraryProvider3 interfész.

ppCordb
[kifelé] Mutató egy COM-objektumra mutató mutatóra (IUnknown). Ez az objektum a visszaadása előtt egy ICorDebug objektumba kerül.

Visszaadott érték

S_OK
ppCordb egy érvényes objektumra hivatkozik, amely megvalósítja az ICorDebug interfészt .

E_INVALIDARG
szDebuggeeVersion Vagy ppCordb null értékű.

CORDBG_E_DEBUG_COMPONENT_MISSING
A CLR-hibakereséshez szükséges összetevő nem található. Vagy mscordbi.dll vagy mscordaccore.dll nem található ugyanabban a könyvtárban, mint a cél CoreCLR.dll.

CORDBG_E_INCOMPATIBLE_PROTOCOL
Vagy mscordbi.dll vagy mscordaccore.dll nem ugyanaz a verzió, mint a cél CoreCLR.dll.

E_FAIL (vagy egyéb E_ visszatérési kódok)
Nem sikerült visszaadni egy ICorDebug-felületet.

Megjegyzések

A visszaadott felület lehetővé teszi a CLR-hez való kapcsolódást egy célfolyamatban, és hibakeresést tesz lehetővé a CLR által futtatott felügyelt kódban.

Követelmények

Platformok: Lásd: .NET által támogatott operációs rendszerek.

Fejléc: dbgshim.h

Könyvtár: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

.NET-verziók: A .NET 6.0 óta érhető el