Compartilhar via


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