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.

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

Consulte também

• Função CorBindToCurrentRuntime
• Função CorBindToRuntime
• Função CorBindToRuntimeByCfg
• Função CorBindToRuntimeEx
• ICorRuntimeHost Interface
• Funções de hospedagem CLR preteridas