Função GetRequestedRuntimeInfo

Artigo
05/10/2023

Obtém informações de versão e diretório sobre o CLR (Common Language Runtime) solicitado por um aplicativo.

Essa função foi preterida 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
[in] O nome do aplicativo.

pwszVersion
[in] Uma cadeia de caracteres que especifica o número de versão do runtime.

pConfigurationFile
[in] O nome do arquivo de configuração está associado a pExe.

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

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

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

dwDirectory
[in] O comprimento do buffer de diretório.

dwDirectoryLength
[out] Um ponteiro para o comprimento da cadeia de caracteres de caminho do diretório.

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

cchBuffer
[in] O comprimento do buffer de cadeia de caracteres de versão.

dwlength
[out] Um ponteiro para o comprimento da cadeia de caracteres de versão.

Valor Retornado

Esse método retorna códigos de erro COM (Component Object Model) padrão, conforme definido em WinError.h, além dos valores a seguir.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
ERROR_INSUFFICIENT_BUFFER	O buffer de diretório não é grande o suficiente para armazenar o caminho do diretório. - ou - O buffer da versão não é grande o suficiente para armazenar a cadeia de caracteres de versão.

Comentários

O método GetRequestedRuntimeInfo retorna informações 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, você pode obter informações sobre a versão mais recente instalada usando o método GetRequestedRuntimeInfo da seguinte maneira:

Especifique os parâmetros pExe, pwszVersion e pConfigurationFile como nulos.
Especifique o sinalizador RUNTIME_INFO_UPGRADE_VERSION nas enumerações RUNTIME_INFO_FLAGS do parâmetro runtimeInfoFlags.

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

Existe um arquivo de configuração de aplicativo que especifica o carregamento de uma versão CLR específica. Observe que o .NET Framework usará o arquivo de configuração mesmo se você especificar nulo para o parâmetro pConfigurationFile.
O método CorBindToRuntimeEx foi chamado especificando uma versão anterior do CLR.
Um aplicativo que foi compilado para uma versão anterior do CLR está em execução no momento.

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

RUNTIME_INFO_REQUEST_IA64
RUNTIME_INFO_REQUEST_AMD64
RUNTIME_INFO_REQUEST_X86

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: MSCorEE.dll

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

Compartilhar via