Função MsiGetFileVersionA (msi.h)
O MsiGetFileVersion retorna a cadeia de caracteres de versão e a cadeia de caracteres de idioma no formato que o instalador espera encontrá-los no banco de dados. Se você quiser apenas informações de versão, defina lpLangBuf e pcchLangBuf como 0 (zero). Se você quiser apenas informações de idioma, defina lpVersionBuf e pcchVersionBuf como 0 (zero).
Sintaxe
UINT MsiGetFileVersionA(
[in] LPCSTR szFilePath,
[out] LPSTR lpVersionBuf,
[in, out] LPDWORD pcchVersionBuf,
[out] LPSTR lpLangBuf,
[in, out] LPDWORD pcchLangBuf
);
Parâmetros
[in] szFilePath
Especifica o caminho para o arquivo.
[out] lpVersionBuf
Retorna a versão do arquivo.
Defina como 0 apenas para informações de idioma.
[in, out] pcchVersionBuf
Contagem de buffers de entrada e saída como o número de TCHAR.
Defina como 0 (zero) somente para informações de idioma. Na entrada, esse é o tamanho total do buffer, incluindo um espaço para um caractere nulo de terminação. Se o buffer passado for muito pequeno, a contagem retornada não incluirá o caractere nulo de terminação.
[out] lpLangBuf
Retorna o idioma do arquivo.
Defina como 0 (zero) somente para informações de versão.
[in, out] pcchLangBuf
Contagem de buffers de entrada e saída como o número de TCHAR.
Defina como 0 (zero) somente para informações de versão. Na entrada, esse é o tamanho total do buffer, incluindo um espaço para um caractere nulo de terminação. Se o buffer passado for muito pequeno, a contagem retornada não incluirá o caractere nulo de terminação.
Valor retornado
| Valor | Significado |
|---|---|
|
Conclusão bem-sucedida. |
|
Arquivo inexistente. |
|
O arquivo não pode ser aberto para obter informações de versão. |
|
O arquivo não contém informações de versão. |
|
As informações de versão são inválidas. |
|
Erro inesperado. |
Comentários
Observação
O cabeçalho msi.h define MsiGetFileVersion como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer. |
| Plataforma de Destino | Windows |
| Cabeçalho | msi.h |
| Biblioteca | Msi.lib |
| DLL | Msi.dll |