Função CorBindToRuntimeHost

  • Artigo

Permite que os hosts carreguem uma versão especificada do CLR (Common Language Runtime) em um processo.

Essa função foi preterida no .NET Framework 4.

Sintaxe

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 cadeia de caracteres que descreve a versão do CLR que você deseja carregar.

Um número de versão no .NET Framework consiste em quatro partes separadas por pontos: major.minor.build.revision. A cadeia de caracteres passada como pwszVersion deve começar com o caractere "v" seguido das três primeiras partes do número de versão (por exemplo, "v1.0.1529").

Algumas versões do CLR são instaladas com uma declaração de política que especifica a compatibilidade com versões anteriores do CLR. Por padrão, o shim de inicialização avalia pwszVersion em relação às instruções de política e carrega a versão mais recente do runtime compatível com a versão solicitada. Um host pode forçar o shim a ignorar a avaliação da política e carregar a versão exata especificada em pwszVersion passando um valor de STARTUP_LOADER_SAFEMODE para o parâmetro startupFlags.

Se pwszVersion for null, o método não carrega nenhuma versão do CLR. Em vez disso, ele retorna CLR_E_SHIM_RUNTIMELOAD, o que indica que ele falhou ao carregar o runtime.

pwszBuildFlavor
[in] Uma cadeia de caracteres que especifica se deve carregar o servidor ou a compilação da estação de trabalho do CLR. Os valores válidos são svr e wks. A compilação do servidor é otimizada para tirar proveito de vários processadores para coletas de lixo e a compilação da estação de trabalho é otimizada para aplicativos cliente executados em uma máquina de processador único.

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

Observação

Não há suporte para coleta de lixo simultânea em aplicativos que executam o emulador WOW64 x86 em sistemas de 64 bits que implementam a arquitetura Intel Itanium (anteriormente chamada IA-64). Para obter mais informações sobre como usar o WOW64 em sistemas Windows de 64 bits, consulte Executar aplicativos de 32 bits.

pwszHostConfigFile
[in] O nome de um arquivo de configuração de host que especifica a versão do CLR a ser carregada. Se o nome do arquivo não incluir um caminho totalmente qualificado, será considerado que o arquivo está no mesmo diretório que o executável que está fazendo a chamada.

pReserved
[in] Reservado para extensibilidade futura.

startupFlags
[in] Um conjunto de sinalizadores que controla a coleta de lixo simultânea, o código neutro do domínio e o comportamento do parâmetro pwszVersion. O padrão será domínio único se nenhum sinalizador for definido. Para ver uma lista de valores com suporte, confira a enumeração STARTUP_FLAGS.

rclsid
[in] O CLSID da coclass que implementa a interface ICorRuntimeHost ou ICLRRuntimeHost. Os valores com suporte são CLSID_CorRuntimeHost ou CLSID_CLRRuntimeHost.

riid
[in] O IID da interface que você está solicitando. Os valores com suporte são IID_ICorRuntimeHost ou IID_ICLRRuntimeHost.

ppv
[out] Um ponteiro de interface para a versão do runtime que foi carregado.

Requisitos

Plataformas: confira Requisitos do sistema.

Header: MSCorEE.idl

Biblioteca: MSCorEE.dll

Versões do .NET Framework: Disponíveis desde a versão 1.0

Confira também