Função CorBindToRuntimeHost

Artigo
08/25/2010

Permite que hosts carregar uma versão especificada do common linguagem tempo de execução (CLR) em um processo.

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 do .NET estrutura consiste em quatro partes separadas por pontos: Major.minor.compilação.Revision. A cadeia de caracteres passada sistema autônomo pwszVersiondeve iniciar com o caractere "v" seguido sistema autônomo primeiras três partes do número de versão (por exemplo, "v1.0.1529").

Algumas versões do CLR são instalados com uma demonstrativo de diretiva que especifica compatibilidade com versões anteriores do CLR. Por padrão, a correção de inicialização avalia pwszVersion contra instruções de políticas 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 carregue a versão exata especificada em pwszVersion passando um valor de STARTUP_LOADER_SAFEMODE para o startupFlags parâmetro.

Se o chamador especificar nulo para pwszVersion, a versão mais recente do CLR é carregada. Passar nulo não, o host nenhum controle através do qual versão do tempo de execução é carregada. Embora essa abordagem pode ser adequada em algumas situações, é altamente recomendável que o host de fornece uma versão específica para carregar.

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álido são svr e wks. A compilação do servidor é otimizada para usufruir os vários processadores para coletas de lixo e a compilação de estação de trabalho é otimizada para aplicativos cliente executados em uma computador de processador único.

If pwszBuildFlavoris set to null, the workstation build is loaded. When running on a single-processor machine, the workstation build is always loaded, even if pwszBuildFlavoris set to svr. However, if pwszBuildFlavoris set to svr and concurrent garbage collection is specified (see the description of the startupFlags parameter), the server build is loaded.

Observação:
Coleta de lixo simultâneas não há suporte para aplicativos executados no WOW64 x86 emulador em sistemas de 64 bit que implementam a arquitetura Intel Itanium (anteriormente chamado IA-64). Para obter mais informações sobre o uso do WOW64 em sistemas Windows de 64 bit, consulte Executando aplicativos de 32 bit.

pwszHostConfigFile
[in] O nome de um arquivo de configuração de host que especifica a versão do CLR para carregar. Se nome de arquivo não incluir um caminho totalmente qualificado, o arquivo será considerado no mesmo diretório que o executável que está fazendo a telefonar.
pReserved
[in] Reservado para futura extensibilidade.
startupFlags
[in] Um conjunto de sinalizadores que controla lixo simultâneo coleção, código de domínio neutro e o comportamento do pwszVersion parâmetro. O padrão é o único domínio se nenhum sinalizar estiver definido. Há suporte para os seguintes valores:
- STARTUP_CONCURRENT_GC: Especifica que lixo simultâneo coleção deve ser usado. Se o chamador pede a compilação do servidor e especifica a coleta de lixo simultâneas em uma computador de processador único, a criação de estação de trabalho e a coleta de lixo simultânea não serão usadas em vez disso.
- STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN: Especifica que nenhum assemblies são carregados sistema autônomo domínio neutro.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN: Especifica que todos sistema autônomo assemblies são carregados sistema autônomo domínio neutro.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST: Especifica que todos sistema autônomo assemblies com nome forte sejam carregados sistema autônomo 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] The CLSID de coclass que implementa a interface você está procurando. Há suporte para os valores são CLSID_CorRuntimeHost ou nulo.
riid
[in] The IID da interface que você está solicitando. Os valores com suporte para a versão inicial do tempo de execução são IID_ICorRuntimeHost ou nulo.
ppv
[out] Um ponteiro de interface para a versão do tempo de execução que foi carregado.