CreateDebuggingInterfaceFromVersionEx 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 CreateDebuggingInterfaceFromVersionEx (
    [in] int iDebuggerVersion,
    [in] LPCWSTR szDebuggeeVersion,
    [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.

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 Core 2.1 óta érhető el