IHostControl::GetHostManager (Método)

Obtiene un puntero de interfaz a la implementación del host de la interfaz con la IID especificada.

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

Parámetros

• riid
  [in] Variable IID de la interfaz que Common Language Runtime (CLR) está consultando.

• ppObject
  [out] Puntero a la interfaz implementada en el host, o NULL si el host no admite esta interfaz.

Valor devuelto

HRESULT	Descripción
S_OK	GetHostManager finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	CLR no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	La variable IID solicitada no es válida.
E_NOINTERFACE	No se admite la interfaz solicitada.

Comentarios

CLR consulta el host para determinar si éste 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 dicha interfaz. En caso contrario, establece ppObject en NULL.

CLR no llama a Release en los administradores de host, aun cuando lo cierre.

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: MSCorEE.h

Biblioteca: Se incluye como recurso en MsCorEE.dll

Versiones de .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vea también

Referencia

IHostControl (Interfaz)

Historial de cambios

Fecha	Historial	Motivo
Diciembre de 2010	Se clarificó que nunca se llama a Release en administradores de host.	Corrección de errores de contenido.