Recurso VERSIONINFO

Define um recurso de informações de versão. O recurso contém essas informações sobre o arquivo como seu número de versão, seu sistema operacional pretendido e seu nome de arquivo original. O recurso destina-se a ser usado com as funções de Informações de Versão .

Há duas maneiras de formatar uma instrução VERSIONINFO :

versionID VERSIONINFO fixed-info  { block-statement . . . }

- ou -

versionID VERSIONINFO 
fixed-info
BEGIN
block-statement
. . .
END

Parâmetros

Versionid

Identificador de recurso de informações de versão. Esse valor deve ser 1.

fixed-info

Informações de versão, como a versão do arquivo e o sistema operacional pretendido. Esse parâmetro consiste nas instruções a seguir.

Instrução	Descrição
Versão FILEVERSION	Número de versão binária para o arquivo. A versão consiste em dois inteiros de 32 bits, definidos por quatro inteiros de 16 bits. Por exemplo, "FILEVERSION 3,10,0,61" é convertido em duas palavras duplas: 0x0003000a e 0x0000003d, nessa ordem. Portanto, se a versão for definida pelos valores DWORDdw1 e dw2, ela precisará aparecer na instrução FILEVERSION da seguinte maneira: HIWORD(dw1), LOWORD(dw1), HIWORD(dw2), . LOWORD(dw2)
Versão PRODUCTVERSION	Número de versão binária para o produto com o qual o arquivo é distribuído. O parâmetro de versão é dois inteiros de 32 bits, definidos por quatro inteiros de 16 bits. Para obter mais informações sobre a versão, consulte a descrição FILEVERSION .
FILEFLAGSMASKfileflagsmask	Indica quais bits na instrução FILEFLAGS são válidos. Para o Windows de 16 bits, esse valor é 0x3f.
FileFLAGSfileflags	Atributos do arquivo.
FILEOS fileos	Sistema operacional para o qual esse arquivo foi projetado. O parâmetro fileos pode ser um dos valores do sistema operacional fornecidos na seção Comentários.
Tipo de arquivoFILETYPE	Tipo geral de arquivo. O parâmetro filetype pode ser um dos valores de tipo de arquivo listados na seção Comentários.
SubtipoFILESUBTYPE	Função do arquivo. O parâmetro de subtipo é zero, a menos que o parâmetro filetype na instrução FILETYPE seja VFT_DRV, VFT_FONT ou VFT_VXD. Para obter uma lista de valores de subtipo de arquivo, consulte a seção Comentários.

 

instrução block

Especifica um ou mais blocos de informações de versão. Um bloco pode conter informações de cadeia de caracteres ou informações de variáveis. Para obter mais informações, consulte StringFileInfo Block ou VarFileInfo Block.

Comentários

Para usar as constantes especificadas com a instrução VERSIONINFO , você deve incluir o arquivo de cabeçalho Winver.h ou Windows.h no arquivo de definição de recurso.

A lista a seguir descreve os parâmetros usados na instrução VERSIONINFO :

Fileflags

Uma combinação dos valores a seguir.

Valor	Descrição
VS_FF_DEBUG	O arquivo contém informações de depuração ou é compilado com recursos de depuração habilitados.
VS_FF_PATCHED	O arquivo foi modificado e não é idêntico ao arquivo de envio original do mesmo número de versão.
VS_FF_PRERELEASE	O arquivo é uma versão de desenvolvimento, não um produto lançado comercialmente.
VS_FF_PRIVATEBUILD	O arquivo não foi criado usando procedimentos de versão padrão. Se esse valor for fornecido, o bloco StringFileInfo deverá conter uma cadeia de caracteres PrivateBuild .
VS_FF_SPECIALBUILD	O arquivo foi criado pela empresa original usando procedimentos de versão padrão, mas é uma variação do arquivo padrão do mesmo número de versão. Se esse valor for fornecido, o bloco de bloco StringFileInfo deverá conter uma cadeia de caracteres SpecialBuild.
VS_FFI_FILEFLAGSMASK	Uma combinação de todos os valores anteriores.

 

fileos

Um dos valores a seguir.

Valor	Descrição
VOS_UNKNOWN	O sistema operacional para o qual o arquivo foi projetado é desconhecido.
VOS_DOS	O arquivo foi projetado para MS-DOS.
VOS_NT	O arquivo foi projetado para o Windows de 32 bits.
VOS__WINDOWS16	O arquivo foi projetado para o Windows de 16 bits.
VOS__WINDOWS32	O arquivo foi projetado para o Windows de 32 bits.
VOS_DOS_WINDOWS16	O arquivo foi projetado para o Windows de 16 bits em execução com MS-DOS.
VOS_DOS_WINDOWS32	O arquivo foi projetado para o Windows de 32 bits em execução com MS-DOS.
VOS_NT_WINDOWS32	O arquivo foi projetado para o Windows de 32 bits.

 

Os valores 0x00002L, 0x00003L, 0x20000L e 0x30000L são reservados.

Filetype

Um dos valores a seguir.

Valor	Descrição
VFT_UNKNOWN	O tipo de arquivo é desconhecido.
VFT_APP	O arquivo contém um aplicativo.
VFT_DLL	O arquivo contém uma DLL (biblioteca de vínculo dinâmico).
VFT_DRV	O arquivo contém um driver de dispositivo. Se o tipo de arquivo for VFT_DRV, o subtipo conterá uma descrição mais específica do driver.
VFT_FONT	O arquivo contém uma fonte. Se filetype for VFT_FONT, o subtipo conterá uma descrição mais específica da fonte.
VFT_VXD	O arquivo contém um dispositivo virtual.
VFT_STATIC_LIB	O arquivo contém uma biblioteca de link estático.

 

Todos os outros valores são reservados para uso pela Microsoft.

Subtipo

Informações adicionais sobre o tipo de arquivo.

Se filetypeespecificar VFT_DRV, esse parâmetro poderá ser um dos valores a seguir.

Valor	Descrição
VFT2_UNKNOWN	O tipo de driver é desconhecido.
VFT2_DRV_COMM	O arquivo contém um driver de comunicações.
VFT2_DRV_PRINTER	O arquivo contém um driver de impressora.
VFT2_DRV_KEYBOARD	O arquivo contém um driver de teclado.
VFT2_DRV_LANGUAGE	O arquivo contém um driver de idioma.
VFT2_DRV_DISPLAY	O arquivo contém um driver de exibição.
VFT2_DRV_MOUSE	O arquivo contém um driver de mouse.
VFT2_DRV_NETWORK	O arquivo contém um driver de rede.
VFT2_DRV_SYSTEM	O arquivo contém um driver do sistema.
VFT2_DRV_INSTALLABLE	O arquivo contém um driver instalável.
VFT2_DRV_SOUND	O arquivo contém um driver de som.
VFT2_DRV_VERSIONED_PRINTER	O arquivo contém um driver de impressora com versão.

 

Se filetypeespecificar VFT_FONT, esse parâmetro poderá ser um dos valores a seguir.

Valor	Descrição
VFT2_UNKNOWN	O tipo de fonte é desconhecido.
VFT2_FONT_RASTER	O arquivo contém uma fonte raster.
VFT2_FONT_VECTOR	O arquivo contém uma fonte de vetor.
VFT2_FONT_TRUETYPE	O arquivo contém uma fonte TrueType.

 

Se o tipo de arquivo especificar VFT_VXD, esse parâmetro deverá ser o identificador de dispositivo virtual incluído no bloco de controle do dispositivo virtual.

Todos os valores de subtipo não listados aqui são reservados para uso pela Microsoft.

Langid

Um dos seguintes códigos de idioma.

Código	Linguagem	Código	Linguagem
0x0401	Árabe	0x0415	Polonês
0x0402	Búlgaro	0x0416	Português (Brasil)
0x0403	Catalão	0x0417	Rhaeto-Romanic
0x0404	Chinês tradicional	0x0418	Romeno
0x0405	Tcheco	0x0419	Russo
0x0406	Dinamarquês	0x041A	Croato-Serbian (latino)
0x0407	Alemão	0x041B	Eslovaco
0x0408	Grego	0x041C	Albanês
0x0409	Inglês dos EUA	0x041D	Sueco
0x040A	Espanhol castiliano	0x041e	Tailandês
0x040B	Finlandês	0x041F	Turco
0x040C	Francês	0x0420	Urdu
0x040D	Hebraico	0x0421	Bahasa
0x040E	Húngaro	0x0804	Chinês simplificado
0x040F	Islandês	0x0807	Alemão suíço
0x0410	Italiano	0x0809	Inglês do Reino Unido
0x0411	Japonês	0x080A	Espanhol (México)
0x0412	Coreano	0x080C	Francês belga
0x0413	Holandês	0x0C0C	Francês do Canadá
0x0414	Norueguês? Bokmal	0x100C	Francês suíço
0x0810	Italiano suíço	0x0816	Português (Portugal)
0x0813	Holandês belga	0x081A	Serbo-Croatian (cirílico)
0x0814	Norueguês? Nynorsk

 

charsetID

Um dos seguintes identificadores de conjunto de caracteres.

Decimal	Hexadecimal	Conjunto de caracteres
0	0000	ASCII de 7 bits
932	03A4	Japão (Shift? JIS X-0208)
949	03B5	Coreia (Shift? KSC 5601)
950	03B6	Taiwan (Big5)
1200	04B0	Unicode
1250	04E2	Latino-2 (Leste Europeu)
1251	04E3	Cirílico
1252	04E4	Multilíngue
1253	04E5	Grego
1254	04E6	Turco
1255	04E7	Hebraico
1256	04E8	Árabe

 

nome da cadeia de caracteres

Um dos nomes predefinidos a seguir.

Nome	Descrição
Comentários	Informações adicionais que devem ser exibidas para fins de diagnóstico.
CompanyName	Empresa que produziu o arquivo , por exemplo, Microsoft Corporation ou Standard Microsystems Corporation, Inc. Essa cadeia de caracteres é necessária.
FileDescription	Descrição do arquivo a ser apresentada aos usuários. Essa cadeia de caracteres pode ser exibida em uma caixa de listagem quando o usuário está escolhendo arquivos para instalar, por exemplo, Keyboard Driver for AT-Style Keyboards. Essa cadeia de caracteres é necessária.
FileVersion	Número de versão do arquivo , por exemplo, 3.10 ou 5.00.RC2. Essa cadeia de caracteres é necessária.
InternalName	Nome interno do arquivo, se houver, por exemplo, um nome de módulo se o arquivo for uma biblioteca de vínculo dinâmico. Se o arquivo não tiver nenhum nome interno, essa cadeia de caracteres deverá ser o nome de arquivo original, sem extensão. Essa cadeia de caracteres é necessária.
LegalCopyright	Avisos de direitos autorais que se aplicam ao arquivo. Isso deve incluir o texto completo de todos os avisos, símbolos legais, datas de direitos autorais e assim por diante. Essa cadeia de caracteres é opcional.
LegalTrademarks	Marcas comerciais e marcas registradas que se aplicam ao arquivo. Isso deve incluir o texto completo de todos os avisos, símbolos legais, números de marca e assim por diante. Essa cadeia de caracteres é opcional.
OriginalFilename	Nome original do arquivo, sem incluir um caminho. Essas informações permitem que um aplicativo determine se um arquivo foi renomeado por um usuário. O formato do nome depende do sistema de arquivos para o qual o arquivo foi criado. Essa cadeia de caracteres é necessária.
PrivateBuild	Informações sobre uma versão privada do arquivo , por exemplo, Built by TESTER1 on \\TESTBED. Essa cadeia de caracteres só deverá estar presente se VS_FF_PRIVATEBUILD for especificado no parâmetro fileflags do bloco raiz.
ProductName	Nome do produto com o qual o arquivo é distribuído. Essa cadeia de caracteres é necessária.
ProductVersion	Versão do produto com o qual o arquivo é distribuído, por exemplo, 3.10 ou 5.00.RC2. Essa cadeia de caracteres é necessária.
Specialbuild	Texto que especifica como essa versão do arquivo difere da versão padrão, por exemplo, Private build for TESTER1 solving mouse problems on M250 and M250E computers. Essa cadeia de caracteres só deverá estar presente se VS_FF_SPECIALBUILD for especificado no parâmetro fileflags do bloco raiz.

 

Determinados atributos também têm suporte para compatibilidade com versões anteriores. Para obter mais informações, consulte Atributos de recurso comuns.

Exemplos

O exemplo a seguir define um recurso VERSIONINFO :

#define VER_FILEVERSION             3,10,349,0
#define VER_FILEVERSION_STR         "3.10.349.0\0"

#define VER_PRODUCTVERSION          3,10,0,0
#define VER_PRODUCTVERSION_STR      "3.10\0"

#ifndef DEBUG
#define VER_DEBUG                   0
#else
#define VER_DEBUG                   VS_FF_DEBUG
#endif

VS_VERSION_INFO VERSIONINFO
FILEVERSION     VER_FILEVERSION
PRODUCTVERSION  VER_PRODUCTVERSION
FILEFLAGSMASK   VS_FFI_FILEFLAGSMASK
FILEFLAGS       (VER_PRIVATEBUILD|VER_PRERELEASE|VER_DEBUG)
FILEOS          VOS__WINDOWS32
FILETYPE        VFT_DLL
FILESUBTYPE     VFT2_UNKNOWN
BEGIN
    BLOCK "StringFileInfo"
    BEGIN
        BLOCK "040904E4"
        BEGIN
            VALUE "CompanyName",      VER_COMPANYNAME_STR
            VALUE "FileDescription",  VER_FILEDESCRIPTION_STR
            VALUE "FileVersion",      VER_FILEVERSION_STR
            VALUE "InternalName",     VER_INTERNALNAME_STR
            VALUE "LegalCopyright",   VER_LEGALCOPYRIGHT_STR
            VALUE "LegalTrademarks1", VER_LEGALTRADEMARKS1_STR
            VALUE "LegalTrademarks2", VER_LEGALTRADEMARKS2_STR
            VALUE "OriginalFilename", VER_ORIGINALFILENAME_STR
            VALUE "ProductName",      VER_PRODUCTNAME_STR
            VALUE "ProductVersion",   VER_PRODUCTVERSION_STR
        END
    END

    BLOCK "VarFileInfo"
    BEGIN
        /* The following line should only be modified for localized versions.     */
        /* It consists of any number of WORD,WORD pairs, with each pair           */
        /* describing a language,codepage combination supported by the file.      */
        /*                                                                        */
        /* For example, a file might have values "0x409,1252" indicating that it  */
        /* supports English language (0x409) in the Windows ANSI codepage (1252). */

        VALUE "Translation", 0x409, 1252

    END
END

Confira também

Usando informações de versão

Informações sobre versão