Recurso VERSIONINFO

Artículo
06/13/2023

Define un recurso de información de versión. El recurso contiene dicha información sobre el archivo como su número de versión, su sistema operativo previsto y su nombre de archivo original. El recurso está pensado para usarse con las funciones información de versión .

Hay dos maneras de dar formato a una instrucción VERSIONINFO :

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

O bien

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

Parámetros

versionID

Identificador de recursos de información de versión. Este valor debe ser 1.

fixed-info

Información de versión, como la versión del archivo y el sistema operativo previsto. Este parámetro consta de las siguientes instrucciones.

.	Descripción
Versión de FILEVERSION	Número de versión binario del archivo. La versión consta de dos enteros de 32 bits, definidos por cuatro enteros de 16 bits. Por ejemplo, "FILEVERSION 3,10,0,61" se traduce en dos palabras dobles: 0x0003000a y 0x0000003d, en ese orden. Por lo tanto, si los valores DWORDdw1 y dw2 definen la versión, deben aparecer en la instrucción FILEVERSION de la siguiente manera: `HIWORD(dw1)`, `LOWORD(dw1)`, `HIWORD(dw2)`, `LOWORD(dw2)`.
Versión de PRODUCTVERSION	Número de versión binaria del producto con el que se distribuye el archivo. El parámetro version es dos enteros de 32 bits, definidos por cuatro enteros de 16 bits. Para obtener más información sobre la versión, vea la descripción de FILEVERSION .
FILEFLAGSMASKfileflagsmask	Indica qué bits de la instrucción FILEFLAGS son válidos. Para Windows de 16 bits, este valor es 0x3f.
FILEFLAGSfileflags	Atributos del archivo.
FILEOS fileos	Sistema operativo para el que se diseñó este archivo. El parámetro fileos puede ser uno de los valores del sistema operativo proporcionados en la sección Comentarios.
FILETYPE filetype	Tipo general de archivo. El parámetro filetype puede ser uno de los valores de tipo de archivo enumerados en la sección Comentarios.
Subtipo FILESUBTYPE	Función del archivo. El parámetro de subtipo es cero a menos que el parámetro filetype de la instrucción FILETYPE sea VFT_DRV, VFT_FONT o VFT_VXD. Para obtener una lista de los valores de subtipo de archivo, vea la sección Comentarios.

block-statement

Especifica uno o varios bloques de información de versión. Un bloque puede contener información de cadena o información de variables. Para obtener más información, vea StringFileInfo Block o VarFileInfo Block.

Comentarios

Para usar las constantes especificadas con la instrucción VERSIONINFO , debe incluir el archivo de encabezado Winver.h o Windows.h en el archivo de definición de recursos.

En la lista siguiente se describen los parámetros usados en la instrucción VERSIONINFO :

fileflags

Combinación de los valores siguientes.

Value	Descripción
VS_FF_DEBUG	El archivo contiene información de depuración o se compila con las características de depuración habilitadas.
VS_FF_PATCHED	El archivo se ha modificado y no es idéntico al archivo de envío original del mismo número de versión.
VS_FF_PRERELEASE	El archivo es una versión de desarrollo, no un producto publicado comercialmente.
VS_FF_PRIVATEBUILD	El archivo no se creó mediante procedimientos de versión estándar. Si se proporciona este valor, el bloque StringFileInfo debe contener una cadena de PrivateBuild .
VS_FF_SPECIALBUILD	El archivo fue creado por la empresa original con procedimientos de versión estándar, pero es una variación del archivo estándar del mismo número de versión. Si se da este valor, el bloque de bloque StringFileInfo debe contener una cadena SpecialBuild.
VS_FFI_FILEFLAGSMASK	Combinación de todos los valores anteriores.

fileos

Uno de los siguientes valores.

Valor	Descripción
VOS_UNKNOWN	El sistema operativo para el que se diseñó el archivo es desconocido.
VOS_DOS	El archivo se diseñó para MS-DOS.
VOS_NT	El archivo se diseñó para Windows de 32 bits.
VOS__WINDOWS16	El archivo se diseñó para Windows de 16 bits.
VOS__WINDOWS32	El archivo se diseñó para Windows de 32 bits.
VOS_DOS_WINDOWS16	El archivo se diseñó para Windows de 16 bits que se ejecuta con MS-DOS.
VOS_DOS_WINDOWS32	El archivo se diseñó para Windows de 32 bits que se ejecuta con MS-DOS.
VOS_NT_WINDOWS32	El archivo se diseñó para Windows de 32 bits.

Los valores 0x00002L, 0x00003L, 0x20000L y 0x30000L están reservados.

Eltipo

Uno de los siguientes valores.

Valor	Descripción
VFT_UNKNOWN	El tipo de archivo es desconocido.
VFT_APP	El archivo contiene una aplicación.
VFT_DLL	El archivo contiene una biblioteca de vínculos dinámicos (DLL).
VFT_DRV	El archivo contiene un controlador de dispositivo. Si filetype es VFT_DRV, el subtipo contiene una descripción más específica del controlador.
VFT_FONT	El archivo contiene una fuente. Si filetype es VFT_FONT, el subtipo contiene una descripción más específica de la fuente.
VFT_VXD	El archivo contiene un dispositivo virtual.
VFT_STATIC_LIB	El archivo contiene una biblioteca de vínculos estáticos.

Todos los demás valores están reservados para su uso por Parte de Microsoft.

Subtipo

Información adicional sobre el tipo de archivo.

Si filetype especifica VFT_DRV, este parámetro puede ser uno de los valores siguientes.

Value	Descripción
VFT2_UNKNOWN	El tipo de controlador es desconocido.
VFT2_DRV_COMM	El archivo contiene un controlador de comunicaciones.
VFT2_DRV_PRINTER	El archivo contiene un controlador de impresora.
VFT2_DRV_KEYBOARD	El archivo contiene un controlador de teclado.
VFT2_DRV_LANGUAGE	El archivo contiene un controlador de idioma.
VFT2_DRV_DISPLAY	El archivo contiene un controlador de pantalla.
VFT2_DRV_MOUSE	El archivo contiene un controlador del mouse.
VFT2_DRV_NETWORK	El archivo contiene un controlador de red.
VFT2_DRV_SYSTEM	El archivo contiene un controlador del sistema.
VFT2_DRV_INSTALLABLE	El archivo contiene un controlador instalable.
VFT2_DRV_SOUND	El archivo contiene un controlador de sonido.
VFT2_DRV_VERSIONED_PRINTER	El archivo contiene un controlador de impresora con versiones.

Si filetype especifica VFT_FONT, este parámetro puede ser uno de los siguientes valores.

Value	Descripción
VFT2_UNKNOWN	El tipo de fuente es desconocido.
VFT2_FONT_RASTER	El archivo contiene una fuente ráster.
VFT2_FONT_VECTOR	El archivo contiene una fuente vectorial.
VFT2_FONT_TRUETYPE	El archivo contiene una fuente TrueType.

Si filetype especifica VFT_VXD, este parámetro debe ser el identificador de dispositivo virtual incluido en el bloque de control de dispositivo virtual.

Todos los valores de subtipo que no aparecen aquí están reservados para su uso por Parte de Microsoft.

langID

Uno de los siguientes códigos de idioma.

Código	Idioma	Código	Idioma
0x0401	Árabe	0x0415	Polaco
0x0402	Búlgaro	0x0416	Portugués (Brasil)
0x0403	Catalán	0x0417	Rhaeto-Romanic
0x0404	Chino tradicional	0x0418	Rumano
0x0405	Checo	0x0419	Ruso
0x0406	Danés	0x041A	Croato-Serbian (latino)
0x0407	Alemán	0x041B	Eslovaco
0x0408	Griego	0x041C	Albanés
0x0409	Inglés de EE. UU.	0x041D	Sueco
0x040A	Español castellano	0x041E	Tailandés
0x040B	Finés	0x041F	Turco
0x040C	Francés	0x0420	Urdu
0x040D	Hebreo	0x0421	Bahasa
0x040E	Húngaro	0x0804	Chino simplificado
0x040F	Islandés	0x0807	Alemán suizo
0x0410	Italiano	0x0809	Inglés de Reino Unido
0x0411	Japonés	0x080A	Español (México)
0x0412	Coreano	0x080C	Francés belga
0x0413	Neerlandés	0x0C0C	Francés canadiense
0x0414	¿Noruego? Bokmal	0x100C	Francés suizo
0x0810	Italiano suizo	0x0816	Portugués (Portugal)
0x0813	Neerlandés belga	0x081A	Serbo-Croatian (cirílico)
0x0814	¿Noruego? Nynorsk

charsetID

Uno de los siguientes identificadores de juego de caracteres.

Decimal	Hexadecimal	Juego de caracteres
0	0000	ASCII de 7 bits
932	03A4	Japón (Shift ? JIS X-0208)
949	03B5	Corea (Shift ? KSC 5601)
950	03B6	Taiwán (Big5)
1200	04B0	Unicode
1250	04E2	Latino-2 (Europa oriental)
1251	04E3	Cirílico
1252	04E4	Multilingüe
1253	04E5	Griego
1254	04E6	Turco
1255	04E7	Hebreo
1256	04E8	Árabe

string-name

Uno de los siguientes nombres predefinidos.

Nombre	Descripción
Comentarios	Información adicional que se debe mostrar con fines de diagnóstico.
CompanyName	Compañía que generó el archivo, por ejemplo, `Microsoft Corporation` o `Standard Microsystems Corporation, Inc.` Esta cadena es necesaria.
FileDescription	Descripción del archivo que se va a presentar a los usuarios. Esta cadena se puede mostrar en un cuadro de lista cuando el usuario elige archivos para instalar, por ejemplo, `Keyboard Driver for AT-Style Keyboards`. Esta cadena es necesaria.
FileVersion	Número de versión del archivo, por ejemplo, `3.10` o `5.00.RC2`. Esta cadena es necesaria.
InternalName	Nombre interno del archivo, si existe, por ejemplo, un nombre de módulo si el archivo es una biblioteca de vínculos dinámicos. Si el archivo no tiene ningún nombre interno, esta cadena debe ser el nombre de archivo original, sin extensión. Esta cadena es necesaria.
LegalCopyright	Avisos de copyright que se aplican al archivo. Esto debe incluir el texto completo de todos los avisos, símbolos legales, fechas de copyright, etc. Esta cadena es opcional.
LegalTrademarks	Marcas comerciales y marcas registradas que se aplican al archivo. Esto debe incluir el texto completo de todos los avisos, símbolos legales, números de marcas comerciales, etc. Esta cadena es opcional.
OriginalFilename	Nombre original del archivo, no incluida una ruta de acceso. Esta información permite a una aplicación determinar si un usuario ha cambiado el nombre de un archivo. El formato del nombre depende del sistema de archivos para el que se creó el archivo. Esta cadena es necesaria.
PrivateBuild	Información sobre una versión privada del archivo, por ejemplo, `Built by TESTER1 on \\TESTBED`. Esta cadena solo debe estar presente si se especifica VS_FF_PRIVATEBUILD en el parámetro fileflags del bloque raíz.
ProductName	Nombre del producto con el que se distribuye el archivo. Esta cadena es necesaria.
ProductVersion	Versión del producto con el que se distribuye el archivo( por ejemplo, `3.10` o `5.00.RC2`. Esta cadena es necesaria.
SpecialBuild	Texto que especifica cómo difiere esta versión del archivo de la versión estándar, por ejemplo, `Private build for TESTER1 solving mouse problems on M250 and M250E computers`. Esta cadena solo debe estar presente si VS_FF_SPECIALBUILD se especifica en el parámetro fileflags del bloque raíz.

Algunos atributos también se admiten para la compatibilidad con versiones anteriores. Para obtener más información, consulte Atributos de recursos comunes.

Ejemplos

En el ejemplo siguiente se define un 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

Consulte también

Uso de la información de versión
Información de versión

Compartir a través de

Recurso VERSIONINFO

Parámetros

Comentarios

Ejemplos

Consulte también

Comentarios

Recursos adicionales