Função MsiGetFileVersionA (msi.h)

Artigo
11/20/2024

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 desejar 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 somente 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 encerramento.

[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 encerramento.

Valor de retorno

Valor	Significado
ERROR_SUCCESS	Conclusão bem-sucedida.
ERROR_FILE_NOT_FOUND	O arquivo não existe.
ERROR_ACCESS_DENIED	O arquivo não pode ser aberto para obter informações de versão.
ERROR_FILE_INVALID	O arquivo não contém informações de versão.
ERROR_INVALID_DATA	As informações de versão são inválidas.
E_FAIL	Erro inesperado.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou Windows Vista. Windows Installer no Windows Server 2003 ou Windows XP. Consulte os Requisitos de Run-Time do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
da Plataforma de Destino	Windows
cabeçalho	msi.h
biblioteca	Msi.lib
de DLL	Msi.dll

Consulte também

Funções de status do sistema

Compartilhar via