ICorRuntimeHost

Actualización: noviembre 2007

Proporciona métodos que permiten al host iniciar y detener Common Language Runtime (CLR) de forma explícita, crear y configurar dominios de aplicación, tener acceso al dominio predeterminado y enumerar todos los dominios que se están ejecutando en el proceso.

En la versión 2.0 de .NET Framework, esta interfaz ha sido reemplazada por ICLRRuntimeHost.

interface ICorRuntimeHost : IUnknown { 
    HRESULT CloseEnum (
        [in] HCORENUM hEnum
    );
    HRESULT CreateDomain (
        [in] LPWSTR pwzFriendlyName,
        [in] IUnknown* pIdentityArray, 
        [out] void ** pAppDomain
    );
    HRESULT CreateDomainEx (
        [in] LPCWSTR pwzFriendlyName, 
        [in] IUnknown* pSetup, 
        [in] IUnknown* pEvidence, 
        [out] IUnknown** pAppDomain
    );
    HRESULT CreateDomainSetup (
        [out] IUnknown** pAppDomainSetup
    );
    HRESULT CreateEvidence (
        [out] IUnknown** pEvidence
    );
    HRESULT CreateLogicalThreadState();
    HRESULT CurrentDomain (
        [out] IUnknown** pAppDomain
    );
    HRESULT DeleteLogicalThreadState();
    HRESULT EnumDomains (
        [out] HCORENUM *hEnum
    );
        HRESULT GetConfiguration(
            [out] ICorConfiguration** pConfiguration
        );
    HRESULT GetDefaultDomain (
        [out] IUnknown** pAppDomain
    );
    HRESULT LocksHeldByLogicalThread(
             [out] DWORD *pCount 
        );
    HRESULT NextDomain (
        [in] HCORENUM hEnum,
        [out] void** pAppDomain
    );
    HRESULT Start ();
    HRESULT Stop ();
    HRESULT SwitchInLogicalThreadState(
             [in] DWORD *pFiberCookie);
    HRESULT SwitchOutLogicalThreadState(
             [out] DWORD **pFiberCookie);
    HRESULT UnloadDomain (
        [in] IUnknown* pAppDomain
    ); 
}

Métodos

Método	Descripción
ICorRuntimeHost::CloseEnum (Método)	Restablece un enumerador de dominio al principio de la lista de dominios.
ICorRuntimeHost::CreateDomain (Método)	Crea un dominio de aplicación. El llamador recibe un puntero de interfaz de tipo _AppDomain a una instancia de tipo System.AppDomain.
ICorRuntimeHost::CreateDomainEx (Método)	Crea un dominio de aplicación. Este método permite al llamador pasar una instancia de IAppDomainSetup para configurar más características de la instancia de _AppDomain devuelta.
ICorRuntimeHost::CreateDomainSetup (Método)	Obtiene un puntero de interfaz de tipo IAppDomainSetup a una instancia de AppDomainSetup. IAppDomainSetup proporciona métodos para configurar una serie de aspectos del dominio de aplicación antes de crearse.
ICorRuntimeHost::CreateEvidence (Método)	Obtiene un puntero de interfaz de tipo IIdentity, que permite al host crear la evidencia de seguridad que se pasa a CreateDomain o CreateDomainEx.
ICorRuntimeHost::CreateLogicalThreadState (Método)	No utilice esta etiqueta.
ICorRuntimeHost::CurrentDomain (Método)	Obtiene un puntero de interfaz de tipo _AppDomain que representa el dominio cargado en el subproceso actual.
ICorRuntimeHost::DeleteLogicalThreadState (Método)	No utilice esta etiqueta.
ICorRuntimeHost::EnumDomains (Método)	Obtiene un enumerador para los dominios del proceso actual.
ICorRuntimeHost::GetConfiguration (Método)	Obtiene un objeto que permite al host especificar la configuración de devolución de llamada de CLR.
ICorRuntimeHost::GetDefaultDomain (Método)	Obtiene un puntero de interfaz de tipo _AppDomain que representa el dominio predeterminado para el proceso actual.
ICorRuntimeHost::LocksHeldByLogicalThread (Método)	No utilice esta etiqueta.
ICorRuntimeHost::MapFile (Método)	Asigna el archivo especificado en la memoria. Este método está obsoleto.
ICorRuntimeHost::NextDomain (Método)	Obtiene un puntero de interfaz al dominio siguiente de la enumeración.
ICorRuntimeHost::Start (Método)	Inicia CLR.
ICorRuntimeHost::Stop (Método)	Detiene la ejecución de código en el motor en tiempo de ejecución para el proceso actual.
ICorRuntimeHost::SwitchInLogicalThreadState (Método)	No utilice esta etiqueta.
ICorRuntimeHost::SwitchOutLogicalThreadState (Método)	No utilice esta etiqueta.
ICorRuntimeHost::UnloadDomain (Método)	Descarga el dominio de aplicación especificado del proceso actual.

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: MSCorEE.idl

Biblioteca: Se incluye como recurso en MsCorEE.dll

.NET Framework, versiones: 1.0, 1.1

Vea también

Conceptos

Hosts del motor en tiempo de ejecución

Referencia

AppDomain

IAppDomainSetup

ICLRRuntimeHost

Otros recursos

Alojar Common Language Runtime

Interfaces de hospedaje