Interface ICorRuntimeHost

Fornece métodos que permitem que o host para iniciar e interromper explicitamente, o common linguagem tempo de execução (CLR) para criar e configurar domínios de aplicativos, para acessar o domínio padrão e enumerar todos os domínios em execução no processo.

No .NET estrutura versão 2.0, essa interface é substituída 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	Descrição
Método ICorRuntimeHost::CloseEnum	Redefine um enumerador de domínio de volta para o início da lista de domínio.
Método ICorRuntimeHost::CreateDomain	Cria um domínio do aplicativo. O chamador recebe um ponteiro de interface do tipo _AppDomain para uma instância de tipo System.AppDomain.
Método ICorRuntimeHost::CreateDomainEx	Cria um domínio do aplicativo. Esse método permite que o chamador passe um IAppDomainSetup instância para configurar os recursos adicionais do retornado _AppDomain instância.
Método ICorRuntimeHost::CreateDomainSetup	Obtém um ponteiro de interface do tipo IAppDomainSetup para um AppDomainSetup instância. IAppDomainSetup Fornece métodos para configurar aspectos de um domínio do aplicativo antes de ser criada.
Método ICorRuntimeHost::CreateEvidence	Obtém um ponteiro de interface do tipo IIdentity, que permite criar evidência de segurança para passar para o host CreateDomain or CreateDomainEx.
Método ICorRuntimeHost::CreateLogicalThreadState	Não use.
Método ICorRuntimeHost::CurrentDomain	Obtém um ponteiro de interface do tipo _AppDomain que representa o domínio carregado no thread corrente.
Método ICorRuntimeHost::DeleteLogicalThreadState	Não use.
Método ICorRuntimeHost::EnumDomains	Obtém um enumerador para os domínios do processo corrente.
Método ICorRuntimeHost::GetConfiguration	Obtém um objeto que permite que o host especificar a configuração de retorno de chamada do CLR.
Método ICorRuntimeHost::GetDefaultDomain	Obtém um ponteiro de interface do tipo _AppDomain que representa o domínio padrão para o processo corrente.
Método ICorRuntimeHost::LocksHeldByLogicalThread	Não use.
Método ICorRuntimeHost::MapFile	Mapeia o arquivo especificado na memória. Esse método está obsoleto.
Método ICorRuntimeHost::NextDomain	Obtém um ponteiro de interface para o próximo domínio na enumeração.
Método ICorRuntimeHost::Start	Inicia o CLR.
Método ICorRuntimeHost::Stop	Interrompe a execução de código em tempo de execução para o processo corrente.
Método ICorRuntimeHost::SwitchInLogicalThreadState	Não use.
Método ICorRuntimeHost::SwitchOutLogicalThreadState	Não use.
Método ICorRuntimeHost::UnloadDomain	Descarrega o domínio do aplicativo especificado do processo corrente.

Requisitos

Plataformas: See Requisitos de sistema do .NET framework.

Cabeçalho: MSCorEE.idl

Biblioteca: Incluído sistema autônomo um recurso em MSCorEE.dll

Versões do .NET estrutura: 1.0, 1.1

Consulte também

Conceitos

Hosts em tempo de execução

Referência

AppDomain

Interface IAppDomainSetup

Interface ICLRRuntimeHost

Outros recursos

Hospedagem do Common Language Runtime

Interfaces de hospedagem