Interface ICLRRuntimeHost

Artigo
08/25/2010

Fornece funcionalidade semelhante à que o ICorRuntimeHost interface fornecida no .NET estrutura versão 1, com as seguintes alterações:

A adição do SetHostControl método para conjunto a interface de controle de host.
A omissão do alguns métodos fornecidos 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	Descrição
Método ICLRRuntimeHost::ExecuteApplication	Usado em cenários de implantação de ClickOnce baseada em manifesto para especificar o aplicativo para ser ativado em um novo domínio.
Método ICLRRuntimeHost::ExecuteInAppDomain	Especifica o AppDomain no qual deseja executar o código gerenciado especificado.
Método ICLRRuntimeHost::ExecuteInDefaultAppDomain	Chama o método especificado do tipo especificado no assembly especificado.
Método ICLRRuntimeHost::GetCLRControl	Obtém um ponteiro de interface do tipo ICLRControl que hospeda pode usar para personalizar aspectos do common linguagem tempo de execução (CLR).
Método ICLRRuntimeHost::GetCurrentAppDomainId	Obtém o identificador numérico do AppDomain que está sendo executado no momento.
Método ICLRRuntimeHost::SetHostControl	Define a interface de controle de host. Você deve chamar SetHostControl antes de ligar Start.
Método ICLRRuntimeHost::Start	Inicializa o CLR em um processo.
Método ICLRRuntimeHost::Stop	Interrompe a execução de código em tempo de execução.
Método ICLRRuntimeHost::UnloadAppDomain	Descarrega o AppDomain que corresponde ao identificador numérico especificado.

Comentários

O host obtém um ponteiro para um ICLRRuntimeHost instância chamando CorBindToRuntimeEx or CorBindToCurrentRuntime. Para fornecer implementações de qualquer uma das tecnologias fornecidas no .NET estrutura versão 2.0, você deve usar ICLRRuntimeHost em vez de ICorRuntimeHost.

Observação importante:
Não telefonar o Iniciar método antes de chamar o ExecuteApplication método para ativar um aplicativo baseado no manifesto. Se o Start método é chamado primeiro, o ExecuteApplication telefonar de método irá falhar.