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

Метод IHostControl::GetHostManager

  • Статья

Получает указатель интерфейса на реализацию интерфейса основным приложением с заданным значением IID.

HRESULT GetHostManager (
    [in] REFIID riid,
    [out, iid_is(riid)] void** ppObject
);

Параметры

  • riid
    [in] Значение IID интерфейса, запрашиваемого средой CLR.

  • ppObject
    [out] Указатель на реализованный основным приложением интерфейс или значение NULL, если основное приложение не поддерживает этот интерфейс.

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

HRESULT

Описание

S_OK

Метод GetHostManager успешно возвратил значение.

HOST_E_CLRNOTAVAILABLE

Среда CLR не загружена в процесс или находится в состоянии, в котором ей не удается выполнить управляемый код или успешно обработать вызов.

HOST_E_TIMEOUT

Время ожидания вызова истекло.

HOST_E_NOT_OWNER

Вызывающий объект не владеет блокировкой.

HOST_E_ABANDONED

Событие, которого ожидал заблокированный поток или нить, было отменено.

E_FAIL

Произошел неизвестный разрушительный сбой. Если метод вернет значение E_FAIL, среду CLR более нельзя будет использовать в данном процессе. Последующие вызовы методов размещения возвращают значение HOST_E_CLRNOTAVAILABLE.

E_INVALIDARG

Недопустимое запрашиваемое значение IID.

E_NOINTERFACE

Запрашиваемый интерфейс не поддерживается.

Заметки

Среда CLR обращается с запросом к основному приложению, чтобы определить, поддерживает ли оно один или несколько следующих интерфейсов:

Если основное приложение поддерживает указанный интерфейс, он задает в качестве значения параметра ppObject его реализацию этого интерфейса. В противном случае оно задает для ppObject значение NULL.

Среда CLR не вызывает Release для диспетчеров узла, даже когда вы их завершаете.

Требования

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

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

Библиотека: включена как ресурс в MSCorEE.dll

Версии платформы .NET Framework: 4, 3.5 с пакетом обновления 1 (SP1), 3.5, 3.0 с пакетом обновления 1 (SP1), 3.0, 2.0 с пакетом обновления 1 (SP1), 2.0

См. также

Ссылки

Интерфейс IHostControl

Журнал изменений

Дата

Журнал

Причина

Декабрь 2010

Уточнено, что Release никогда не вызывается на диспетчерах основных приложений.

Исправление ошибки содержимого.