Função CorBindToRuntimeHost
Permite que os hosts carreguem uma versão especificada do Common Language Runtime (CLR) em um processo.
Esta 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
[em] 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 pelas três primeiras partes do número da versão (por exemplo, "v1.0.1529").
Algumas versões do CLR são instaladas com uma instruçã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 tempo de execução que é compatível com a versão que está sendo solicitada. Um host pode forçar o shim a ignorar a avaliação da política e carregar a versão exata especificada passando pwszVersion um valor de STARTUP_LOADER_SAFEMODE para o startupFlags parâmetro.
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 tempo de execução.
pwszBuildFlavor
[em] Uma cadeia de caracteres que especifica se o servidor ou a compilação da estação de trabalho do CLR deve ser carregada. Os valores válidos são svr e wks. A compilação do servidor é otimizada para aproveitar 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 null, a compilação da estação de trabalho será carregada. Quando executada em uma máquina de processador único, a compilação da estação de trabalho é sempre carregada, mesmo que pwszBuildFlavor esteja definida como svr. No entanto, se pwszBuildFlavor estiver definido como svr e a coleta de lixo simultânea for especificada (consulte a descrição do parâmetro), a compilação do startupFlags servidor será carregada.
Nota
A coleta de lixo simultânea não é suportada 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 Executando aplicativos de 32 bits.
pwszHostConfigFile
[em] 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, presume-se que o arquivo esteja no mesmo diretório que o executável que está fazendo a chamada.
pReserved
[em] Reservado para extensibilidade futura.
startupFlags
[em] Um conjunto de sinalizadores que controla a coleta de lixo simultânea, o código neutro de domínio e o comportamento do pwszVersion parâmetro. O padrão é domínio único se nenhum sinalizador estiver definido. Para obter uma lista de valores suportados, consulte a enumeração STARTUP_FLAGS.
rclsid
[em] O CLSID da coclass que implementa o ICorRuntimeHost ou a interface ICLRRuntimeHost . Os valores suportados são CLSID_CorRuntimeHost ou CLSID_CLRRuntimeHost.
riid
[em] O IID da interface que você está solicitando. Os valores suportados são IID_ICorRuntimeHost ou IID_ICLRRuntimeHost.
ppv
[saídas] Um ponteiro de interface para a versão do tempo de execução que foi carregada.
Requisitos
Plataformas: Consulte Requisitos do sistema.
Cabeçalho: MSCorEE.idl
Biblioteca: MSCorEE.dll
Versões do .NET Framework: Disponível desde 1.0
