Funções de hospedagem CLR reprovadas

  • Artigo

Esta seção descreve as funções estáticas globais não gerenciadas usadas por versões anteriores da API de hospedagem.

Com exceção das funções de infraestrutura (funções _Cor*), que são usadas apenas pelo .NET Framework, essas funções foram preteridas no .NET Framework 4.

Funções de ativação

Função ClrCreateManagedInstance
Preterido. Cria uma instância do tipo gerenciado especificado.

Função CoInitializeCor
Obsoleto. Para inicializar o CLR (Common Language Runtime), use CorBindToRuntimeEx ou CorBindToCurrentRuntime.

Função CoInitializeEE
Preterido. Garante que o mecanismo de execução do CLR seja carregado em um processo. Como alternativa, use o método ICLRRuntimeHost::Start.

Função CorBindToCurrentRuntime
Preterido. Carrega o CLR (Common Language Runtime) em um processo usando informações de versão armazenadas em um arquivo XML.

Função CorBindToRuntime
Preterido. Permite que hosts não gerenciados carreguem o CLR em um processo.

Função CorBindToRuntimeByCfg
Preterido. Carrega o CLR em um processo usando informações de versão lidas a partir de um arquivo XML.

Função CorBindToRuntimeEx
Preterido. Permite que hosts não gerenciados carreguem o CLR em um processo e que você defina sinalizadores para especificar o comportamento do CLR.

Função CorBindToRuntimeHost
Preterido. Permite que os hosts carreguem uma versão especificada do CLR em um processo.

Função GetCORRequiredVersion
Preterido. Obtém o número de versão necessário do CLR.

Função GetCORSystemDirectory
Preterido. Retorna o diretório de instalação do CLR carregado no processo.

Função GetRealProcAddress
Preterido. Obtém o endereço da função especificada que é exportada da versão mais recente instalada do CLR.

Função GetRequestedRuntimeInfo
Preterido. Obtém informações de versão e diretório sobre o CLR solicitado por um aplicativo.

Funções de versão do CLR

As funções nesta seção retornam uma versão CLR. Elas não ativam o CLR.

Função GetCORVersion
Preterido. Obtém o número de versão do CLR em execução no processo atual.

Função GetFileVersion
Preterido. Obtém as informações de versão do CLR do arquivo especificado, usando o buffer especificado.

Função GetRequestedRuntimeVersion
Preterido. Obtém o número de versão do CLR solicitado pelo aplicativo especificado. Se essa versão não estiver instalada, obterá a versão mais recente instalada antes da versão solicitada.

Função GetRequestedRuntimeVersionForCLSID
Preterido. Obtém as informações de versão do CLR corretas para a classe com o CLSID especificado.

Função GetVersionFromProcess
Preterido. Obtém o número de versão do CLR associado ao identificador de processo especificado.

Função LockClrVersion
Preterido. Permite que o host determine qual versão do CLR será usada no processo antes de inicializar explicitamente o CLR.

Funções de hospedagem

Função CallFunctionShim
Preterido. Faz uma chamada para a função que tem o nome e os parâmetros especificados na biblioteca especificada.

Função CoEEShutDownCOM
Preterido. Descarrega um assembly COM do processo.

Função CorExitProcess
Preterido. Desliga o processo não gerenciado atual.

Função CorLaunchApplication
Preterido. Inicia o aplicativo no caminho de rede especificado, usando os manifestos especificados e outros dados do aplicativo.

Função CorMarkThreadInThreadPool
Preterido. Marca o thread de pool de threads em execução no momento para a execução do código gerenciado. A partir do .NET Framework versão 2.0, essa função não tem efeito. Ela não é necessária e pode ser removida do código.

Função CoUninitializeCor
Obsoleto. O CLR não pode ser descarregado de um processo.

Função CoUninitializeEE
Obsoleto.

Função CreateDebuggingInterfaceFromVersion
Preterido. Cria um objeto ICorDebug com base nas informações de versão especificadas.

Função CreateICeeFileGen
Preterido. Cria um objeto ICeeFileGen.

Função DestroyICeeFileGen
Preterido. Destrói um objeto ICeeFileGen.

Ponteiro de função FExecuteInAppDomainCallback
Preterido. Aponta para uma função que o CLR chama para executar o código gerenciado.

Ponteiro de função FLockClrVersionCallback
Preterido. Aponta para uma função que o CLR chama para notificar o host de que a inicialização foi iniciada ou concluída.

Função GetCLRIdentityManager
Preterido. Obtém um ponteiro para uma interface que permite que o CLR gerencie as identidades.

Função LoadLibraryShim
Preterido. Carrega uma versão especificada de um .NET Framework DLL.

Função LoadStringRC
Preterido. Converte um valor HRESULT em uma mensagem de erro usando a cultura padrão do thread atual.

Função LoadStringRCEx
Preterido. Converte um valor HRESULT em uma mensagem de erro apropriada para a cultura especificada.

Ponteiro de função LPOVERLAPPED_COMPLETION_ROUTINE
Preterido. Aponta para uma função que notifica o host quando uma E/S sobreposta (ou seja, assíncrona) para um dispositivo foi concluída.

Ponteiro de função LPTHREAD_START_ROUTINE
Preterido. Aponta para uma função que notifica o host que um thread começou a executar.

Função RunDll32ShimW
Preterido. Executa o comando especificado.

Ponteiro de função WAITORTIMERCALLBACK
Preterido. Aponta para uma função que notifica o host de que um identificador de espera foi sinalizado ou atingiu seu tempo limite.

Funções de infraestrutura

As funções nesta seção são usadas apenas pelo .NET Framework.

Função _CorDllMain
Inicializa o CLR, localiza o ponto de entrada gerenciado no cabeçalho do CLR do assembly DLL e inicia a execução.

Função _CorExeMain
Inicializa o CLR, localiza o ponto de entrada gerenciado no cabeçalho do CLR do assembly executável e inicia a execução.

Função _CorExeMain2
Executa o ponto de entrada no código mapeado na memória especificado. Essa função é chamada pelo carregador do sistema operacional.

Função _CorImageUnloading
Notifica o carregador quando as imagens do módulo gerenciado são descarregadas.

Função _CorValidateImage
Valida as imagens do módulo gerenciado e notifica o carregador do sistema operacional após o carregamento.

Confira também