Função GetRequestedRuntimeInfo

Obtém informações de versão e diretório sobre o tempo de execução da common language (CLR) solicitado por uma aplicação.

Esta função foi obsoleta no .NET Framework 4.

Sintaxe

HRESULT GetRequestedRuntimeInfo (
    [in]  LPCWSTR  pExe,
    [in]  LPCWSTR  pwszVersion,
    [in]  LPCWSTR  pConfigurationFile,
    [in]  DWORD    startupFlags,
    [in]  DWORD    runtimeInfoFlags,
    [out] LPWSTR   pDirectory,
    [in]  DWORD    dwDirectory,
    [out] DWORD   *dwDirectoryLength,
    [out] LPWSTR   pVersion,
    [in]  DWORD    cchBuffer,
    [out] DWORD   *dwlength
);

Parâmetros

pExe [dentro] O nome da candidatura.

pwszVersion [dentro] Uma string que especifica o número de versão do runtime.

pConfigurationFile [dentro] O nome do ficheiro de configuração associado a pExe.

startupFlags [dentro] Um ou mais dos STARTUP_FLAGS valores de enumeração.

runtimeInfoFlags [dentro] Um ou mais dos RUNTIME_INFO_FLAGS valores de enumeração.

pDirectory [fora] Um buffer que contém o caminho do diretório para o runtime após a conclusão bem-sucedida.

dwDirectory [dentro] O comprimento do buffer do diretório.

dwDirectoryLength [fora] Um apontador para o comprimento da cadeia de caminho do diretório.

pVersion [fora] Um buffer que contém o número de versão do runtime após a conclusão bem-sucedida.

cchBuffer [dentro] O comprimento do buffer de string da versão.

dwlength [fora] Um apontador para o comprimento da cadeia de versão.

Valor de retorno

Este método devolve códigos de erro padrão do Component Object Model (COM), conforme definido no WinError.h, além dos seguintes valores.

Observações

O GetRequestedRuntimeInfo método devolve informação em tempo de execução sobre a versão carregada no processo, que não é necessariamente a versão mais recente instalada no computador.

No .NET Framework versão 2.0, pode obter informações sobre a versão mais recente instalada utilizando o GetRequestedRuntimeInfo método seguinte:

• Especifique os pExeparâmetros , pwszVersion, e pConfigurationFile como nulos.

• Especifique a RUNTIME_INFO_UPGRADE_VERSION flag nas RUNTIME_INFO_FLAGS enumerações para o runtimeInfoFlags parâmetro.

O GetRequestedRuntimeInfo método não retorna a versão mais recente do CLR nas seguintes circunstâncias:

• Existe um ficheiro de configuração de aplicação que especifica o carregamento de uma versão específica do CLR. Note que o .NET Framework usará o ficheiro de configuração mesmo que especifique null para o pConfigurationFile parâmetro.

• O método CorBindToRuntimeEx era chamado para especificar uma versão anterior do CLR.

• Uma aplicação que foi compilada para uma versão anterior do CLR está atualmente a funcionar.

Para o runtimeInfoFlags parâmetro, pode especificar apenas uma das constantes de arquitetura da RUNTIME_INFO_FLAGS enumeração de cada vez:

• RUNTIME_INFO_REQUEST_IA64

• RUNTIME_INFO_REQUEST_AMD64

• RUNTIME_INFO_REQUEST_X86

Requerimentos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: MSCorEE.dll

Versões do .NET Framework: Disponível desde a 1.1

Consulte também

• Função GetRequestedRuntimeVersion
• GetVersionFromProcess Function
• Funções de hospedagem CLR preteridas