Função GetRequestedRuntimeInfo
Obtém informações de versão e o diretório sobre o common linguagem tempo de execução (CLR) solicitado por um aplicativo.
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 que especifica o número de versão do tempo de execução.pConfigurationFile
[in] O nome do arquivo de configuração associada 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] 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 códigos de erro COM (componente objeto Model) padrão, conforme definido no WinError.h, juntamente com sistema autônomo 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 string de versão. |
Comentários
The GetRequestedRuntimeInfo método retorna informações sobre a versão carregada no processo, que não é necessariamente a versão mais recente instalada no computador time de execução.
No .NET estrutura versão 2.0, você pode obter informações sobre a versão mais recente instalada usando o GetRequestedRuntimeInfo método da seguinte maneira:
Especifique o pExe, pwszVersion, e pConfigurationFile parâmetros sistema autônomo nulo.
Especificar o sinalizar RUNTIME_INFO_UPGRADE_VERSION no RUNTIME_INFO_FLAGS enumerações para o runtimeInfoFlags parâmetro.
The GetRequestedRuntimeInfo método não retorna a versão mais recente do CLR nas seguintes circunstâncias:
Existe um arquivo de configuração do aplicativo que especifica o carregamento de uma determinada versão CLR. Observe que o .NET estrutura irá usar o arquivo de configuração mesmo que você especifique nulo para o pConfigurationFile parâmetro.
The CorBindToRuntimeEx 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.
O runtimeInfoFlags parâmetro, é possível especificar apenas uma das constantes a arquitetura das RUNTIME_INFO_FLAGS enumeração por vez:
RUNTIME_INFO_REQUEST_IA64
RUNTIME_INFO_REQUEST_AMD64
RUNTIME_INFO_REQUEST_X86
Requisitos
Plataformas: See Requisitos de sistema do .NET framework.
Cabeçalho: MSCorEE.idl
Biblioteca: MSCorEE.dll
.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1
Consulte também
Tarefas
CLR versão detecção Tecnologia Exemplo
Referência
Função GetRequestedRuntimeVersion