Функция CreateDebuggingInterfaceFromVersion (создание интерфейса отладки по версии)

Принимает строку версии среды 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