IHostControl::GetHostManager (Método)

Obtiene un puntero de interfaz a la implementación del host de la interfaz con el elemento IID especificado.

Sintaxis

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

Parámetros

riid
[in] Elemento IID de la interfaz para la que Common Language Runtime (CLR) está realizando la consulta.

ppObject
[out] Puntero a la interfaz implementada por el host o null si el host no admite esta interfaz.

Valor devuelto

HRESULT	Descripción
S_OK	GetHostManager se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE	Si se devuelve este valor, significa que Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado ni procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL	Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	El elemento IID solicitado no es válido.
E_NOINTERFACE	La interfaz solicitada no es compatible.

Comentarios

CLR consulta el host para determinar si admite una o varias de las interfaces siguientes:

• IHostMemoryManager

• IHostTaskManager

• IHostThreadPoolManager

• IHostIoCompletionManager

• IHostSyncManager

• IHostAssemblyManager

• IHostGCManager

• IHostPolicyManager

• IHostSecurityManager

Si el host admite la interfaz especificada, establece ppObject en su implementación de esa interfaz. De lo contrario, establece ppObject en null.

CLR no llama a Release en los administradores del host, incluso cuando se cierra.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también

• IHostControl (Interfaz)