Compartilhar via


Método ICLRMetaHost::GetVersionFromFile

Obtém a versão de compilação .NET Framework original de um assembly (armazenada nos metadados), dado o caminho do arquivo. Esse método substitui a função GetFileVersion.

Sintaxe

HRESULT GetVersionFromFile (  
    [in] LPCWSTR pwzFilePath,  
    [out, size_is(*pcchBuffer)] LPWSTR pwzBuffer,  
    [in, out] DWORD *pcchBuffer);  
);  

Parâmetros

pwzFilePath
[in] O caminho completo do arquivo de assembly.

pwzbuffer
[out] A versão de compilação do .NET Framework armazenada nos metadados, no formato "vA. B[. X]". A, B, e X são números decimais que correspondem à versão principal, à versão secundária e ao número de build. O comprimento dessa cadeia de caracteres é limitado a MAX_PATH.

Observação

Essa saída corresponde ao nome do diretório para a versão do .NET Framework, pois ela aparece em C:\Windows\Microsoft.NET\Framework.

Os valores de exemplo são "v1.0.3705", "v1.1.4322", "v2.0.50727" e "v4.0.X", onde X depende do número de build instalado. Observe que o prefixo "v" é necessário.

pcchBuffer
[in, out] O tamanho de pwzbuffer para evitar sobrecargas de buffer.

Valor Retornado

Esse método retorna os seguintes HRESULTs específicos, bem como erros HRESULT que indicam falha de método.

HRESULT Descrição
S_OK O método foi concluído com sucesso.
E_POINTER pwzbuffer ou pcchBuffer é nulo.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) O buffer é muito pequeno.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MetaHost.h

Biblioteca: incluída como um recurso no MSCorEE.dll

Versões do .NET Framework: disponíveis desde 4

Confira também