CreateDebuggingInterfaceFromVersion funkcja

Akceptuje ciąg wersji środowiska uruchomieniowego języka wspólnego (CLR), który jest zwracany z funkcji CreateVersionStringFromModule i zwraca odpowiedni interfejs debugera (zazwyczaj ICorDebug).

Składnia

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

Parametry

szDebuggeeVersion
[in] Ciąg wersji środowiska CLR w docelowym debuggee, który jest zwracany przez funkcję CreateVersionStringFromModule.

ppCordb
[out] Wskaźnik do wskaźnika do obiektu COM (IUnknown). Ten obiekt zostanie oddany do obiektu ICorDebug , zanim zostanie zwrócony.

Wartość zwracana

S_OK
ppCordb odwołuje się do prawidłowego obiektu, który implementuje interfejs interfejsu ICorDebug .

E_INVALIDARG
Albo szDebuggeeVersion albo ppCordb ma wartość null.

CORDBG_E_DEBUG_COMPONENT_MISSING
Nie można odlokować składnika niezbędnego do debugowania środowiska CLR. Nie można odnaleźć mscordbi.dll lub mscordaccore.dll w tym samym katalogu co docelowy CoreCLR.dll.

CORDBG_E_INCOMPATIBLE_PROTOCOL
mscordbi.dll lub mscordaccore.dll nie jest tą samą wersją co docelowa CoreCLR.dll.

E_FAIL (lub inne E_ kody powrotne)
Nie można zwrócić interfejsu ICorDebug.

Uwagi

Zwracany interfejs udostępnia obiekty do dołączania do środowiska CLR w procesie docelowym i debugowania zarządzanego kodu, który jest uruchomiony przez clR.

Wymagania

Platformy: Zobacz Obsługiwane systemy operacyjne platformy .NET.

Nagłówek: dbgshim.h

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

Wersje platformy .NET: Dostępne od wersji .NET Core 2.1