Compartilhar via

Função GetRequestedRuntimeInfo

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 associado pExea .

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 da cadeia de caracteres de versão.

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

Valor de retorno

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 Description
S_OK O método foi concluído com êxito.
ERROR_INSUFFICIENT_BUFFER O buffer de diretório não é grande o suficiente para armazenar o caminho do diretório.

- ou -

O buffer de versão não é grande o suficiente para armazenar a cadeia de caracteres de versão.

Observações

O GetRequestedRuntimeInfo método retorna informações de runtime 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 da GetRequestedRuntimeInfo seguinte maneira:

  • Especifique os pExepwszVersionparâmetros e pConfigurationFile os parâmetros como nulos.

  • Especifique o sinalizador RUNTIME_INFO_UPGRADE_VERSION 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 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 pConfigurationFile parâmetro.

  • 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 runtimeInfoFlags parâmetro, você 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

Requirements

Plataformas: confira Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: MSCorEE.dll

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

Consulte também

  • Last updated on