Метод 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 не была загружена в процесс или среда 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 запрашивает узел, чтобы определить, поддерживает ли он один или несколько из следующих интерфейсов:

• IHostMemoryManager

• IHostTaskManager

• IHostThreadPoolManager

• IHostIoCompletionManager

• IHostSyncManager

• IHostAssemblyManager

• IHostGCManager

• IHostPolicyManager

• IHostSecurityManager

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

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

Требования

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

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

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

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

См. также раздел

• Интерфейс IHostControl