Função de CorBindToRuntimeHost

Artigo
08/08/2011

Permite que hosts carregar uma versão especificada do common language runtime (CLR) em um processo.

Essa função foi preterida na .NET Framework versão 4.

HRESULT CorBindToRuntimeHost (
    [in] LPCWSTR       pwszVersion, 
    [in] LPCWSTR       pwszBuildFlavor, 
    [in] LPCWSTR       pwszHostConfigFile, 
    [in] VOID*         pReserved, 
    [in] DWORD         startupFlags, 
    [in] REFCLSID      rclsid, 
    [in] REFIID        riid, 
    [out] LPVOID FAR  *ppv
);

Parâmetros

pwszVersion
[in] Uma seqüência de caracteres que descreve a versão do CLR que você deseja carregar.

Um número de versão na.NET Framework consiste em quatro partes separadas por pontos: Major.Minor.Build.Revision. A seqüência passada como pwszVersion deve começar com o caractere "v" seguido as primeiras três partes do número da versão (por exemplo, "v1.0.1529").

Algumas versões do CLR são instalados com uma declaração de diretiva especifica a compatibilidade com versões anteriores do CLR. Por padrão, a correção de inicialização avalia pwszVersion contra declarações de diretiva e carrega a versão mais recente do tempo de execução que é compatível com a versão que está sendo solicitada. Um host pode forçar a correção para ignorar a avaliação da diretiva e carregar a versão exata especificada em pwszVersion , passando um valor de STARTUP_LOADER_SAFEMODE para o startupFlags parâmetro.

Se pwszVersion é null, o método não carrega qualquer versão do CLR. Em vez disso, ele retorna CLR_E_SHIM_RUNTIMELOAD, que indica que ele não carregou o tempo de execução.
pwszBuildFlavor
[in] Uma seqüência de caracteres que especifica se deve carregar o servidor ou a compilação de estação de trabalho do CLR. Os valores válidos são svr e wks. A compilação do servidor está otimizada para aproveitar os vários processadores para coletas de lixo e a compilação de estação de trabalho é otimizada para aplicativos cliente executados em uma máquina de processador único.

Se pwszBuildFlavoré definido como nulo, a compilação de estação de trabalho é carregada. Quando executado em uma máquina de processador único, a compilação de estação de trabalho é sempre carregada, mesmo se pwszBuildFlavoré definida como svr. No entanto, se pwszBuildFlavoré definida como svr e coleta de lixo simultâneos é especificada (consulte a descrição da startupFlags parâmetro), a compilação do servidor é carregada.

Observação

Não há suporte para a coleta de lixo simultâneas em aplicativos em execução no WOW64 x 86 emulador em sistemas de 64 bits que implementam a arquitetura Intel Itanium (anteriormente chamado de IA-64).Para obter mais informações sobre como usar o WOW64 em sistemas de 64 bits do Windows, consulte aplicativos executando 32 bits.
pwszHostConfigFile
[in] O nome de um arquivo de configuração do host que especifica a versão do CLR para carregar. Se o nome do arquivo incluir um caminho totalmente qualificado, presume-se que o arquivo para estar no mesmo diretório do executável que está fazendo a chamada.
pReserved
[in] Reservado para futura extensibilidade.
startupFlags
[in] Um conjunto de sinalizadores que controla a coleta de lixo simultâneas, o código de domínio neutro e o comportamento da pwszVersion parâmetro. O padrão é o único domínio se nenhum sinalizador estiver definido. Os valores a seguir são suportados:
- STARTUP_CONCURRENT_GC: Especifica que a coleta de lixo simultâneas deve ser usada. Se o chamador pede a compilação do servidor e especifica a coleta de lixo simultâneas em uma máquina de processador único, a criação de estação de trabalho e a coleta de lixo de simultâneas não são usados em vez disso.
- STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN: Especifica que nenhum assemblies são carregados como domínio neutro.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN: Especifica que todos os assemblies são carregados como domínio neutro.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST: Especifica que todos os assemblies de nome forte sejam carregados como domínio neutro.
- STARTUP_LOADER_SAFEMODE: Especifica que a versão exata do CLR é passado de pwszVersion será carregado. A correção não avalia a diretiva para determinar a versão mais recente compatível.
rclsid
[in] O CLSID do coclass que implementa um a ICorRuntimeHost ou ICLRRuntimeHost interface. Valores suportados são CLSID_CorRuntimeHost ou CLSID_CLRRuntimeHost.
riid
[in] O IID da interface que você está solicitando. Valores suportados são IID_ICorRuntimeHost ou IID_ICLRRuntimeHost.
ppv
[out] Um ponteiro de interface para a versão do runtime que foi carregado.