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 CorporationouStandard 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.10ou5.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.10ou5.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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de