Функция CreateDebuggingInterfaceFromVersion3

Статья
09/22/2023

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

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