Функция CreateDebuggingInterfaceFromVersion

Статья
03/02/2024

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

Синтаксис

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

Параметры

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

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 Core 2.1

Поделиться через