Função CorBindToRuntimeHost
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
