Функция CreateDebuggingInterfaceFromVersion (платформа .NET Framework)

Статья
09/22/2023

Создает объект ICorDebug на основе указанной информации о версии.

Эта функция устарела в платформа .NET Framework 4. Вместо этого, чтобы получить интерфейс для среды CLR 2.0, используйте метод ICLRRuntimeInfo::GetInterface и укажите идентификатор класса CLSID_CLRDebuggingLegacy и идентификатор интерфейса IID_ICorDebug. Чтобы получить интерфейс для СРЕДЫ CLR 4 или более поздней версии, вызовите функцию CLRCreateInstance и укажите идентификатор класса CLSID_CLRDebugging и идентификатор интерфейса IID_ICLRDebugging.

Синтаксис

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

Параметры

iDebuggerVersion
[in] Версия ICorDebug этого ожидается отладчиком. См. перечисление CorDebugInterfaceVersion для допустимых значений.

szDebuggeeVersion
[in] Версия среды CLR, связанная с приложением или процессом для отладки. Сведения о получении этого значения см. в методе GetVersionFromProcess или GetRequestedRuntimeVersion .

ppCordb
[out] Расположение, которое получает указатель на ICorDebug объект.

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

Этот метод возвращает стандартные коды ошибок COM, как определено в файле WinError.h в дополнение к следующим значениям.

Код возврата	Description
S_OK	Метод завершился успешно.
E_INVALIDARG	`szDebuggeeVersion` значение `ppCordb` NULL или строка версии некорректна.

Замечания

Параметр szDebuggeeVersion сопоставляется с соответствующей версией MSCorDbi.dll.

Требования

Платформы: см. раздел Требования к системе.

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

Библиотека: MSCorEE.dll

версии платформа .NET Framework: Доступно с версии 2.0

См. также

Устаревшие функции размещения CLR

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