Informações sobre versão

As informações de versão facilitam a instalação correta de arquivos por aplicativos e permitem que os programas de instalação analisem arquivos instalados no momento. O recurso de informações de versão contém o número de versão do arquivo, seu sistema operacional pretendido e o nome do arquivo original.

Nesta seção

Nome	Descrição
Sobre informações de versão	Discute as funções de informações de versão.
Usando informações de versão	Discute como usar as funções de informações de versão.
Referência de informações de versão	Contém a referência de API.

Funções de informações de versão

Nome	Descrição
GetFileVersionInfo	Recupera informações de versão do arquivo especificado.
GetFileVersionInfoEx	Recupera informações de versão do arquivo especificado.
GetFileVersionInfoSize	Determina se o sistema operacional pode recuperar informações de versão de um arquivo especificado. Se as informações de versão estiverem disponíveis, GetFileVersionInfoSize retornará o tamanho, em bytes, dessas informações.
GetFileVersionInfoSizeEx	Determina se o sistema operacional pode recuperar informações de versão de um arquivo especificado. Se as informações de versão estiverem disponíveis, GetFileVersionInfoSizeEx retornará o tamanho, em bytes, dessas informações.
VerFindFile	Determina onde instalar um arquivo com base em se ele localiza outra versão do arquivo no sistema. Os valores que VerFindFile retorna nos buffers especificados são usados em uma chamada subsequente para a função VerInstallFile .
VerInstallFile	Instala o arquivo especificado com base nas informações retornadas da função VerFindFile . VerInstallFile descompacta o arquivo, se necessário, atribui um nome de arquivo exclusivo e verifica se há erros, como arquivos desatualizados.
VerLanguageName	Recupera uma cadeia de caracteres de descrição para o idioma associado a um identificador de idioma binário da Microsoft especificado.
VerQueryValue	Recupera informações de versão especificadas do recurso de informações de versão especificado. Para recuperar o recurso apropriado, antes de chamar VerQueryValue, você deve primeiro chamar a função GetFileVersionInfoSize e, em seguida, a função GetFileVersionInfo .

Estruturas de informações de versão

Nome	Descrição
String	Descreve a organização de dados em um recurso de versão de arquivo. Ele contém uma cadeia de caracteres que descreve um aspecto específico de um arquivo, por exemplo, a versão de um arquivo, seus avisos de direitos autorais ou suas marcas registradas.
StringFileInfo	Descreve a organização de dados em um recurso de versão de arquivo. Ele contém informações de versão que podem ser exibidas para um idioma específico e uma página de código.
Stringtable	Descreve a organização de dados em um recurso de versão de arquivo. Ele contém informações de formatação de página de código e idioma para as cadeias de caracteres especificadas pelo membro Children . Uma página de código é um conjunto de caracteres ordenado.
Var	Descreve a organização de dados em um recurso de versão de arquivo. Normalmente, ele contém uma lista de pares de identificador de página de código e idioma que a versão do aplicativo ou DLL dá suporte.
VarFileInfo	Descreve a organização de dados em um recurso de versão de arquivo. Ele contém informações de versão não dependentes de uma combinação de página de código e idioma específico.
VS_FIXEDFILEINFO	Contém informações de versão sobre um arquivo. Essas informações são independentes de linguagem e de código.
VS_VERSIONINFO	Descreve a organização de dados em um recurso de versão de arquivo. É a estrutura raiz que contém todas as outras estruturas de informações de versão do arquivo.