CreateDebuggingInterfaceFromVersion3, 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 CreateDebuggingInterfaceFromVersion3 (
    [in] int iDebuggerVersion,
    [in] LPCWSTR szDebuggeeVersion,
    [in] LPCWSTR szApplicationGroupId,
    [in] ICLRDebuggingLibraryProvider3* pLibraryProvider,
    [out] IUnknown** ppCordb,
);

Parametry

iDebuggerVersion
[in] Wersja interfejsu oczekiwana przez debuger.

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

szApplicationGroupId
[in] Ciąg reprezentujący identyfikator grupy aplikacji procesu w trybie piaskownicy uruchomiony w systemie macOS. Przekaż wartość NULL, jeśli proces nie jest uruchomiony w piaskownicy w systemie macOS lub na innych platformach.

pLibraryProvider
[in] Wystąpienie interfejsu wywołania zwrotnego do lokalizowania interfejsu DBI i DAC. Zobacz interfejs ICLRDebuggingLibraryProvider3 .

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 6.0