Função GetRequestedRuntimeInfo

Artigo
04/08/2023

Obtém informações de versão e diretório sobre o runtime de idioma comum (CLR) pedido por uma aplicação.

Esta 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 da aplicação.

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

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

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

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

pDirectory
[fora] Uma memória intermédia que contém o caminho do diretório para o runtime após a conclusão com êxito.

dwDirectory
[in] O comprimento da memória intermédia do diretório.

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

pVersion
[fora] Uma memória intermédia que contém o número da versão do runtime após a conclusão com êxito.

cchBuffer
[in] O comprimento da memória intermédia da cadeia de carateres de versão.

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

Devolver Valor

Este método devolve códigos de erro padrão do Modelo de Objeto de Componente (COM), conforme definido em WinError.h, além dos seguintes valores.

Código de retorno	Descrição
S_OK	O método foi concluído com êxito.
ERROR_INSUFFICIENT_BUFFER	A memória intermédia do diretório não é suficientemente grande para armazenar o caminho do diretório. - ou - A memória intermédia da versão não é suficientemente grande para armazenar a cadeia de versão.

Observações

O GetRequestedRuntimeInfo método devolve informações de tempo de execução sobre a versão carregada para o 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 instalada mais recente através do método da GetRequestedRuntimeInfo seguinte forma:

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

O GetRequestedRuntimeInfo método não devolve a versão clR mais recente nas seguintes circunstâncias:

Existe um ficheiro de configuração de aplicação que especifica o carregamento de uma versão CLR específica. Tenha em atenção que o .NET Framework utilizará o ficheiro de configuração mesmo que especifique nulo para o pConfigurationFile parâmetro.
O método CorBindToRuntimeEx foi chamado especificando uma versão clR anterior.
Uma aplicação compilada para uma versão clR anterior está atualmente em execução.

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

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: MSCorEE.h

Biblioteca: MSCorEE.dll

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

Partilhar via