ICLRRuntimeHost

Artículo
10/07/2008

Actualización: noviembre 2007

Proporciona una funcionalidad similar a la de la interfaz ICorRuntimeHost proporcionada en la versión 1 de .NET Framework, con los cambios siguientes:

Incorporación del método SetHostControl para establecer la interfaz de control del host.
Omisión de algunos métodos proporcionados por ICorRuntimeHost.

interface ICLRRuntimeHost : IUnknown {
        
    HRESULT ExecuteApplication (
        [in] LPCWSTR                   pwzAppFullName,
        [in] DWORD                     dwManifestPaths,
        [in] LPCWSTR                   *ppwzManifestPaths,   
        [in] DWORD                     dwActivationData,
        [in] LPCWSTR                   *ppwzActivationData,  
        [out] int                      *pReturnValue
    );
        
    HRESULT ExecuteInAppDomain (
        [in] DWORD                     appDomainId, 
        [in] FExecuteInDomainCallback  pCallback,
        [in] void*                     cookie
    );
        
    HRESULT ExecuteInDefaultAppDomain (
        [in] LPCWSTR                   pwzAssemblyPath, 
        [in] LPCWSTR                   pwzTypeName,
        [in] LPCWSTR                   pwzMethodName,
        [in] LPCWSTR                   pwzArgument,
        [out] DWORD                    *pReturnValue
    );
        
    HRESULT GetCLRControl (
        [out] ICLRControl              **pCLRControl
    );
        
    HRESULT GetCurrentAppDomainId (
        [out] DWORD                    *pdwAppDomainId
    );
        
    HRESULT SetHostControl (
        [in] IHostControl              *pHostControl
    );
        
    HRESULT Start();
        
    HRESULT Stop();
        
    HRESULT UnloadAppDomain (
        [in] DWORD                     dwAppDomainId
        [in] BOOL                      fWaitUntilDone
    );
        
};

Métodos

Método	Descripción
ICLRRuntimeHost::ExecuteApplication (Método)	Se utiliza en escenarios de implementación ClickOnce basados en manifiestos para especificar la aplicación que se debe activar en un nuevo dominio.
ICLRRuntimeHost::ExecuteInAppDomain (Método)	Especifica la instancia de AppDomain donde se va a ejecutar el código administrado especificado.
ICLRRuntimeHost::ExecuteInDefaultAppDomain (Método)	Invoca el método especificado del tipo especificado en el ensamblado especificado.
ICLRRuntimeHost::GetCLRControl (Método)	Obtiene un puntero de interfaz de tipo ICLRControl que los host pueden utilizar para personalizar algunos aspectos de Common Language Runtime (CLR).
ICLRRuntimeHost::GetCurrentAppDomainId (Método)	Obtiene el identificador numérico del objeto AppDomain que se está ejecutando actualmente.
ICLRRuntimeHost::SetHostControl (Método)	Establece la interfaz de control del host. Debe llamar a SetHostControl antes de llamar a Start.
ICLRRuntimeHost::Start (Método)	Inicializa CLR en un proceso.
ICLRRuntimeHost::Stop (Método)	Detiene la ejecución de código por el motor en tiempo de ejecución.
ICLRRuntimeHost::UnloadAppDomain (Método)	Descarga el AppDomain que corresponde al identificador numérico especificado.

Comentarios

El host obtiene un puntero a una instancia de ICLRRuntimeHost mediante una llamada a CorBindToRuntimeEx o CorBindToCurrentRuntime. Para proporcionar implementaciones de cualquiera de las tecnologías incluidas en .NET Framework 2.0, debe utilizar ICLRRuntimeHost en lugar de ICorRuntimeHost.

Nota importante:
No llame al método Start antes de llamar al método ExecuteApplication para activar una aplicación basada en manifiestos. Si se llama al método Start primero, la llamada al métodoExecuteApplication generará un error.