Функция CreateDebuggingInterfaceFromVersion3

Принимает строку версии среды CLR, возвращаемую функцией CreateVersionStringFromModule , и возвращает соответствующий интерфейс отладчика (обычно ICorDebug).

Синтаксис

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

Параметры

iDebuggerVersion
[in] Ожидается версия интерфейса отладчика.

szDebuggeeVersion
[in] Строка версии среды CLR в целевом отладчике, возвращаемая функцией CreateVersionStringFromModule .

szApplicationGroupId
[in] Строка, представляющая идентификатор группы приложений изолированного процесса, выполняемого в macOS. Передайте значение NULL, если процесс не выполняется в песочнице в macOS или на других платформах.

pLibraryProvider
[in] Экземпляр интерфейса обратного вызова для поиска DBI и DAC. См. интерфейс ICLRDebuggingLibraryProvider3 .

ppCordb
[out] Указатель на указатель на COM-объект (IUnknown). Этот объект будет приведение к объекту ICorDebug перед возвратом.

Возвращаемое значение

S_OK
ppCordb ссылается на допустимый объект, реализующий интерфейс интерфейса ICorDebug .

E_INVALIDARG
szDebuggeeVersion Либо ppCordb имеет значение NULL.

CORDBG_E_DEBUG_COMPONENT_MISSING
Не удается найти компонент, необходимый для отладки СРЕДЫ CLR. mscordbi.dll или mscordaccore.dll не найден в том же каталоге, что и целевой CoreCLR.dll.

CORDBG_E_INCOMPATIBLE_PROTOCOL
Либо mscordbi.dll, либо mscordaccore.dll не совпадает с версией целевого CoreCLR.dll.

E_FAIL (или другие E_ коды возврата)
Не удается вернуть интерфейс ICorDebug.

Замечания

Возвращенный интерфейс предоставляет средства для присоединения к среде CLR в целевом процессе и отладке управляемого кода, выполняемого средой CLR.

Требования

Платформ: См. сведения о поддерживаемых операционных системах .NET.

Заголовок: dbgshim.h

Библиотека: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Версии .NET: Доступно с .NET 6.0