Função de GetRequestedRuntimeInfo

Artigo
08/08/2011

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

Essa função foi preterida na .NET Framework versão 4.

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 seqüência de caracteres especificando o número de versão do runtime.
pConfigurationFile
[in] O nome do arquivo de configuração que está associado com pExe.
startupFlags
[in] Um ou mais de STARTUP_FLAGS valores de enumeração.
runtimeInfoFlags
[in] Um ou mais de RUNTIME_INFO_FLAGS valores de enumeração.
pDirectory
[out] Um buffer que contém o caminho de diretório para o tempo de execução após a conclusão bem-sucedida.
dwDirectory
[in] O comprimento do buffer de diretório.
dwDirectoryLength
[out] Um ponteiro para o comprimento da seqüência de caracteres de caminho de diretório.
pVersion
[out] Um buffer que contém o número de versão do tempo de execução após a conclusão bem-sucedida.
cchBuffer
[in] O comprimento do buffer de seqüência de caracteres de versão.
dwlength
[out] Um ponteiro para o comprimento da seqüência de caracteres de versão.

Valor de retorno

Esse método retorna os códigos de erro padrão do modelo de objeto componente (COM), conforme definido no Winerror. H, além de para os seguintes valores.

Código de retorno	Descrição
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 seqüência de caracteres de versão.

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 seqüência de caracteres de versão.

Comentários

O GetRequestedRuntimeInfo método retorna informações de tempo de execução sobre a versão carregada no processo, não necessariamente a versão mais recente instalado no computador.

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

Especificar o pExe, pwszVersion, e pConfigurationFile parâmetros como null.
Especificar o sinalizador RUNTIME_INFO_UPGRADE_VERSION na 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 em um arquivo de configuração do aplicativo que especifica o carregamento de uma determinada versão do CLR. Observe que o.NET Framework usará o arquivo de configuração mesmo que você especifique nulo para o pConfigurationFile parâmetro.
O CorBindToRuntimeEx o método foi chamado, especificando uma versão anterior do CLR.
Um aplicativo que foi compilado para uma versão anterior do CLR está sendo executado.

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