Recurso VERSIONINFO
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 CorporationoStandard 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.10o5.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.10o5.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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de