Ressource VERSIONINFO

Article
06/13/2023

Définit une ressource d’informations sur la version. La ressource contient des informations sur le fichier comme son numéro de version, son système d’exploitation prévu et son nom de fichier d’origine. La ressource est destinée à être utilisée avec les fonctions Informations de version .

Il existe deux façons de mettre en forme une instruction VERSIONINFO :

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

- ou -

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

Paramètres

versionID

Identificateur de ressource informations sur la version. Cette valeur doit être 1.

fixed-info

Informations de version, telles que la version du fichier et le système d’exploitation prévu. Ce paramètre se compose des instructions suivantes.

.	Description
VERSION FILEVERSION	Numéro de version binaire du fichier. La version se compose de deux entiers 32 bits, définis par quatre entiers 16 bits. Par exemple, « FILEVERSION 3,10,0,61 » est traduit en deux mots doubles : 0x0003000a et 0x0000003d, dans cet ordre. Par conséquent, si version est définie par les valeurs DWORD dw1 et dw2, elles doivent apparaître dans l’instruction FILEVERSION comme suit : `HIWORD(dw1)`, `LOWORD(dw1)`, `HIWORD(dw2)`, . `LOWORD(dw2)`
Version de PRODUCTVERSION	Numéro de version binaire du produit avec lequel le fichier est distribué. Le paramètre version est deux entiers 32 bits, définis par quatre entiers 16 bits. Pour plus d’informations sur la version, consultez la description FILEVERSION .
FILEFLAGSMASKfileflagsmask	Indique les bits de l’instruction FILEFLAGS qui sont valides. Pour Windows 16 bits, cette valeur est 0x3f.
FILEFLAGSfileflags	Attributs du fichier.
FILEOSfileos	Système d’exploitation pour lequel ce fichier a été conçu. Le paramètre fileos peut être l’une des valeurs de système d’exploitation indiquées dans la section Notes.
Type de fichier FILETYPE	Type de fichier général. Le paramètre filetype peut être l’une des valeurs de type de fichier répertoriées dans la section Notes.
Sous-type FILESUBTYPE	Fonction du fichier. Le paramètre de sous-type est égal à zéro, sauf si le paramètre filetype dans l’instruction FILETYPE est VFT_DRV, VFT_FONT ou VFT_VXD. Pour obtenir la liste des valeurs de sous-type de fichier, consultez la section Remarques.

block-statement

Spécifie un ou plusieurs blocs d’informations de version. Un bloc peut contenir des informations de chaîne ou des informations de variable. Pour plus d’informations, consultez StringFileInfo Block ou VarFileInfo Block.

Notes

Pour utiliser les constantes spécifiées avec l’instruction VERSIONINFO , vous devez inclure le fichier d’en-tête Winver.h ou Windows.h dans le fichier de définition de ressource.

La liste suivante décrit les paramètres utilisés dans l’instruction VERSIONINFO :

fileflags

Combinaison des valeurs suivantes.

Valeur	Description
VS_FF_DEBUG	Le fichier contient des informations de débogage ou est compilé avec les fonctionnalités de débogage activées.
VS_FF_PATCHED	Le fichier a été modifié et n’est pas identique au fichier d’expédition d’origine du même numéro de version.
VS_FF_PRERELEASE	Le fichier est une version de développement, et non un produit commercialisé.
VS_FF_PRIVATEBUILD	Le fichier n’a pas été généré à l’aide de procédures de mise en production standard. Si cette valeur est donnée, le bloc StringFileInfo doit contenir une chaîne PrivateBuild .
VS_FF_SPECIALBUILD	Le fichier a été créé par la société d’origine à l’aide de procédures de mise en production standard, mais il s’agit d’une variante du fichier standard du même numéro de version. Si cette valeur est donnée, le bloc de bloc StringFileInfo doit contenir une chaîne SpecialBuild.
VS_FFI_FILEFLAGSMASK	Combinaison de toutes les valeurs précédentes.

fileos

Une des valeurs suivantes.

Valeur	Description
VOS_UNKNOWN	Le système d’exploitation pour lequel le fichier a été conçu est inconnu.
VOS_DOS	Le fichier a été conçu pour MS-DOS.
VOS_NT	Le fichier a été conçu pour Windows 32 bits.
VOS__WINDOWS16	Le fichier a été conçu pour Windows 16 bits.
VOS__WINDOWS32	Le fichier a été conçu pour Windows 32 bits.
VOS_DOS_WINDOWS16	Le fichier a été conçu pour windows 16 bits s’exécutant avec MS-DOS.
VOS_DOS_WINDOWS32	Le fichier a été conçu pour windows 32 bits s’exécutant avec MS-DOS.
VOS_NT_WINDOWS32	Le fichier a été conçu pour Windows 32 bits.

Les valeurs 0x00002L, 0x00003L, 0x20000L et 0x30000L sont réservées.

Filetype

Une des valeurs suivantes.

Valeur	Description
VFT_UNKNOWN	Le type de fichier est inconnu.
VFT_APP	Le fichier contient une application.
VFT_DLL	Le fichier contient une bibliothèque de liens dynamiques (DLL).
VFT_DRV	Le fichier contient un pilote de périphérique. Si le type de fichier est VFT_DRV, le sous-type contient une description plus spécifique du pilote.
VFT_FONT	Le fichier contient une police. Si le type de fichier est VFT_FONT, le sous-type contient une description plus spécifique de la police.
VFT_VXD	Le fichier contient un appareil virtuel.
VFT_STATIC_LIB	Le fichier contient une bibliothèque de liens statiques.

Toutes les autres valeurs sont réservées à Microsoft.

Sous-type

Informations supplémentaires sur le type de fichier.

Si le type de fichier spécifie VFT_DRV, ce paramètre peut être l’une des valeurs suivantes.

Valeur	Description
VFT2_UNKNOWN	Le type de pilote est inconnu.
VFT2_DRV_COMM	Le fichier contient un pilote de communication.
VFT2_DRV_PRINTER	Le fichier contient un pilote d’imprimante.
VFT2_DRV_KEYBOARD	Le fichier contient un pilote de clavier.
VFT2_DRV_LANGUAGE	Le fichier contient un pilote de langue.
VFT2_DRV_DISPLAY	Le fichier contient un pilote d’affichage.
VFT2_DRV_MOUSE	Le fichier contient un pilote de souris.
VFT2_DRV_NETWORK	Le fichier contient un pilote réseau.
VFT2_DRV_SYSTEM	Le fichier contient un pilote système.
VFT2_DRV_INSTALLABLE	Le fichier contient un pilote installable.
VFT2_DRV_SOUND	Le fichier contient un pilote audio.
VFT2_DRV_VERSIONED_PRINTER	Le fichier contient un pilote d’imprimante avec version.

Si le type de fichier spécifie VFT_FONT, ce paramètre peut être l’une des valeurs suivantes.

Valeur	Description
VFT2_UNKNOWN	Le type de police est inconnu.
VFT2_FONT_RASTER	Le fichier contient une police raster.
VFT2_FONT_VECTOR	Le fichier contient une police vectorielle.
VFT2_FONT_TRUETYPE	Le fichier contient une police TrueType.

Si le type de fichier spécifie VFT_VXD, ce paramètre doit être l’identificateur d’appareil virtuel inclus dans le bloc de contrôle de l’appareil virtuel.

Toutes les valeurs de sous-type non répertoriées ici sont réservées à Microsoft.

langID

Un des codes de langue suivants.

Code	Langage	Code	Langage
0x0401	Arabe	0x0415	Polonais
0x0402	Bulgare	0x0416	Portugais (Brésil)
0x0403	Catalan	0x0417	Rhaeto-Romanic
0x0404	Chinois traditionnel	0x0418	Roumain
0x0405	Tchèque	0x0419	Russe
0x0406	Danois	0x041A	Croato-Serbian (latin)
0x0407	Allemand	0x041B	Slovaque
0x0408	Grec	0x041C	Albanais
0x0409	Anglais aux États-Unis	0x041D	Suédois
0x040A	Espagnol castilien	0x041E	Thaï
0x040B	Finnois	0x041F	Turc
0x040C	Français	0x0420	Ourdou
0x040D	Hébreu	0x0421	Bahasa
0x040E	Hongrois	0x0804	Chinois simplifié
0x040F	Islandais	0x0807	Suisse allemand
0x0410	Italien	0x0809	Anglais au Royaume-Uni
0x0411	Japonais	0x080A	Espagnol (Mexique)
0x0412	Coréen	0x080C	Français belge
0x0413	Néerlandais	0x0C0C	Français (Canada)
0x0414	Norvégien? Bokmal	0x100C	Français suisse
0x0810	Suisse italien	0x0816	Portugais (Portugal)
0x0813	Néerlandais belge	0x081A	Serbo-Croatian (cyrillique)
0x0814	Norvégien? Nynorsk

charsetID

Un des identificateurs de jeu de caractères suivants.

Decimal	Valeur hexadécimale	Jeu de caractères
0	0000	ASCII 7 bits
932	03A4	Japon (Shift ? JIS X-0208)
949	03B5	Corée (Shift ? KSC 5601)
950	03B6	Taïwan (Big5)
1200	04B0	Unicode
1250	04E2	Latin-2 (Europe de l’Est)
1251	04E3	Cyrillique
1252	04E4	Multilingue
1253	04E5	Grec
1254	04E6	Turc
1 255	04E7	Hébreu
1256	04E8	Arabe

string-name

Un des noms prédéfinis suivants.

Nom	Description
Commentaires	Informations supplémentaires qui doivent être affichées à des fins de diagnostic.
CompanyName	Société qui a produit le fichier, par exemple, `Microsoft Corporation` ou `Standard Microsystems Corporation, Inc.` Cette chaîne est requise.
FileDescription	Description du fichier à présenter aux utilisateurs. Cette chaîne peut s’afficher dans une zone de liste lorsque l’utilisateur choisit des fichiers à installer, par exemple. `Keyboard Driver for AT-Style Keyboards` Cette chaîne est obligatoire.
FileVersion	Numéro de version du fichier, par exemple ou `3.105.00.RC2`. Cette chaîne est obligatoire.
InternalName	Nom interne du fichier, s’il en existe un, par exemple, un nom de module si le fichier est une bibliothèque de liens dynamiques. Si le fichier n’a pas de nom interne, cette chaîne doit être le nom de fichier d’origine, sans extension. Cette chaîne est obligatoire.
LegalCopyright	Avis de copyright qui s’appliquent au fichier. Cela doit inclure le texte intégral de tous les avis, symboles juridiques, dates de copyright, etc. Cette chaîne est facultative.
LegalTrademarks	Marques commerciales et marques déposées qui s’appliquent au fichier. Cela doit inclure le texte intégral de la totalité des mentions, symboles légaux, numéros de marques, etc. Cette chaîne est facultative.
OriginalFilename	Nom d’origine du fichier, sans chemin d’accès. Ces informations permettent à une application de déterminer si un fichier a été renommé par un utilisateur. Le format du nom dépend du système de fichiers pour lequel le fichier a été créé. Cette chaîne est obligatoire.
PrivateBuild	Informations sur une version privée du fichier, par exemple . `Built by TESTER1 on \\TESTBED` Cette chaîne ne doit être présente que si VS_FF_PRIVATEBUILD est spécifié dans le paramètre fileflags du bloc racine.
ProductName	Nom du produit avec lequel le fichier est distribué. Cette chaîne est obligatoire.
ProductVersion	Version du produit avec lequel le fichier est distribué, par exemple ou `3.105.00.RC2`. Cette chaîne est obligatoire.
SpecialBuild	Texte qui spécifie la façon dont cette version du fichier diffère de la version standard, par exemple . `Private build for TESTER1 solving mouse problems on M250 and M250E computers` Cette chaîne ne doit être présente que si VS_FF_SPECIALBUILD est spécifié dans le paramètre fileflags du bloc racine.

Certains attributs sont également pris en charge pour la compatibilité descendante. Pour plus d’informations, consultez Attributs de ressources communs.

Exemples

L’exemple suivant définit une ressource 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

Voir aussi

Utilisation des informations de version
Informations sur la version

Partager via