VERSIONINFO-Ressource

Artikel
09/23/2022

Definiert eine Versionsinformationsressource. Die Ressource enthält solche Informationen über die Datei als Versionsnummer, das beabsichtigte Betriebssystem und den ursprünglichen Dateinamen. Die Ressource soll mit den Funktionen für Versionsinformationen verwendet werden.

Es gibt zwei Möglichkeiten zum Formatieren einer VERSIONINFO-Anweisung :

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

- oder -

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

Parameter

versionID

Versionsinformationsressourcenbezeichner. Dieser Wert muss 1 sein.

Fixed-Info

Versionsinformationen, z. B. die Dateiversion und das vorgesehene Betriebssystem. Dieser Parameter besteht aus den folgenden Anweisungen.

-Anweisung.	BESCHREIBUNG
FILEVERSIONversion	Binärversionsnummer für die Datei. Die Version besteht aus zwei 32-Bit-Ganzzahlen, die durch vier 16-Bit-Ganzzahlen definiert sind. Beispielsweise wird "FILEVERSION 3,10,0,61" in zwei Doppelwörter übersetzt: 0x0003000a und 0x0000003d in dieser Reihenfolge. Wenn die Version daher durch die DWORD-Wertedw1 und dw2 definiert ist, müssen sie in der FILEVERSION-Anweisung wie folgt angezeigt werden: `HIWORD(dw1)`, `LOWORD(dw1)HIWORD(dw2)`, . `LOWORD(dw2)`
PRODUCTVERSIONversion	Binärversionsnummer für das Produkt, mit dem die Datei verteilt wird. Der Versionsparameter ist zwei 32-Bit-Ganzzahlen, die durch vier 16-Bit-Ganzzahlen definiert sind. Weitere Informationen zur Version finden Sie in der DATEIVERSION-Beschreibung .
FILEFLAGSMASKfileflagsmasgsmaskmask	Gibt an, welche Bits in der FILEFLAGS-Anweisung gültig sind. Für 16-Bit-Windows ist dieser Wert 0x3f.
FILEFLAGSfileflags	Attribute der Datei.
FILEOSfileos	Betriebssystem, für das diese Datei entwickelt wurde. Der Fileos-Parameter kann eine der im Abschnitt "Hinweise" angegebenen Betriebssystemwerte sein.
FILETYPEfiletype	Allgemeiner Dateityp. Der Dateitypparameter kann eine der im Abschnitt "Hinweise" aufgeführten Dateitypwerte sein.
FILESUBTYPEsubtype	Funktion der Datei. Der Untertypparameter ist null, es sei denn, der Dateitypparameter in der FILETYPE-Anweisung ist VFT_DRV, VFT_FONT oder VFT_VXD. Eine Liste der Dateiuntertypwerte finden Sie im Abschnitt "Hinweise".

Block-Anweisung

Gibt eine oder mehrere Versionsinformationsblöcke an. Ein Block kann Zeichenfolgeninformationen oder Variableninformationen enthalten. Weitere Informationen finden Sie unter StringFileInfo Block oder VarFileInfo Block.

Bemerkungen

Um die mit der VERSIONINFO-Anweisung angegebenen Konstanten zu verwenden, müssen Sie die Winver.h- oder Windows.h-Headerdatei in die Ressourcendefinitionsdatei einschließen.

In der folgenden Liste werden die Parameter beschrieben, die in der VERSIONINFO-Anweisung verwendet werden:

dateiflags

Eine Kombination aus den folgenden Werten.

Wert	Beschreibung
VS_FF_DEBUG	Die Datei enthält Debuginformationen oder wird mit aktivierten Debugfeatures kompiliert.
VS_FF_PATCHED	Die Datei wurde geändert und ist nicht mit der ursprünglichen Versanddatei derselben Versionsnummer identisch.
VS_FF_PRERELEASE	Die Datei ist eine Entwicklungsversion, nicht ein kommerzielles Produkt.
VS_FF_PRIVATEBUILD	Die Datei wurde nicht mithilfe von Standardfreigabeprozeduren erstellt. Wenn dieser Wert angegeben wird, muss der StringFileInfo-Block eine PrivateBuild-Zeichenfolge enthalten.
VS_FF_SPECIALBUILD	Die Datei wurde vom ursprünglichen Unternehmen mit Standardveröffentlichungsverfahren erstellt, ist jedoch eine Variation der Standarddatei derselben Versionsnummer. Wenn dieser Wert angegeben wird, muss der StringFileInfo-Block eine SpecialBuild-Zeichenfolge enthalten.
VS_FFI_FILEFLAGSMASK	Eine Kombination aller vorherigen Werte.

fileos

Einer der folgenden Werte.

Wert	Beschreibung
VOS_UNKNOWN	Das Betriebssystem, für das die Datei entwickelt wurde, ist unbekannt.
VOS_DOS	Die Datei wurde für MS-DOS entwickelt.
VOS_NT	Die Datei wurde für 32-Bit-Windows entwickelt.
VOS__WINDOWS16	Die Datei wurde für 16-Bit-Windows entwickelt.
VOS__WINDOWS32	Die Datei wurde für 32-Bit-Windows entwickelt.
VOS_DOS_WINDOWS16	Die Datei wurde für 16-Bit-Windows mit MS-DOS entwickelt.
VOS_DOS_WINDOWS32	Die Datei wurde für 32-Bit-Windows mit MS-DOS entwickelt.
VOS_NT_WINDOWS32	Die Datei wurde für 32-Bit-Windows entwickelt.

Die Werte 0x00002L, 0x0003L, 0x20000L und 0x30000L sind reserviert.

Filetype

Einer der folgenden Werte.

Wert	Beschreibung
VFT_UNKNOWN	Dateityp ist unbekannt.
VFT_APP	Die Datei enthält eine Anwendung.
VFT_DLL	Die Datei enthält eine dynamische Linkbibliothek (DLL).
VFT_DRV	Die Datei enthält einen Gerätetreiber. Wenn DateitypVFT_DRV ist, enthält Untertyp eine spezifischere Beschreibung des Treibers.
VFT_FONT	Die Datei enthält eine Schriftart. Wenn Dateityp VFT_FONT ist, enthält Untertyp eine spezifischere Beschreibung der Schriftart.
VFT_VXD	Die Datei enthält ein virtuelles Gerät.
VFT_STATIC_LIB	Die Datei enthält eine statische Linkbibliothek.

Alle anderen Werte sind für die Verwendung von Microsoft reserviert.

Untertyp

Weitere Informationen zum Dateityp.

Wenn dateitypeVFT_DRV angibt, kann dieser Parameter eine der folgenden Werte sein.

Wert	Beschreibung
VFT2_UNKNOWN	Der Treibertyp ist unbekannt.
VFT2_DRV_COMM	Die Datei enthält einen Kommunikationstreiber.
VFT2_DRV_PRINTER	Die Datei enthält einen Druckertreiber.
VFT2_DRV_KEYBOARD	Die Datei enthält einen Tastaturtreiber.
VFT2_DRV_LANGUAGE	Die Datei enthält einen Sprachtreiber.
VFT2_DRV_DISPLAY	Die Datei enthält einen Anzeigetreiber.
VFT2_DRV_MOUSE	Die Datei enthält einen Maustreiber.
VFT2_DRV_NETWORK	Die Datei enthält einen Netzwerktreiber.
VFT2_DRV_SYSTEM	Die Datei enthält einen Systemtreiber.
VFT2_DRV_INSTALLABLE	Die Datei enthält einen installierbaren Treiber.
VFT2_DRV_SOUND	Die Datei enthält einen Soundtreiber.
VFT2_DRV_VERSIONED_PRINTER	Die Datei enthält einen versionierten Druckertreiber.

Wenn dateitypeVFT_FONT angibt, kann dieser Parameter eine der folgenden Werte sein.

Wert	Beschreibung
VFT2_UNKNOWN	Schriftarttyp ist unbekannt.
VFT2_FONT_RASTER	Die Datei enthält eine Rasterschriftart.
VFT2_FONT_VECTOR	Die Datei enthält eine Vektorschriftart.
VFT2_FONT_TRUETYPE	Die Datei enthält eine TrueType-Schriftart.

Wenn dateitype VFT_VXD angibt, muss dieser Parameter der virtuelle Gerätebezeichner sein, der im Virtual-Device-Steuerelementblock enthalten ist.

Alle hier aufgeführten Untertypwerte sind für die Verwendung von Microsoft reserviert.

Langid

Eine der folgenden Sprachcodes.

Code	Sprache	Code	Sprache
0x0401	Arabisch	0x0415	Polnisch
0x0402	Bulgarisch	0x0416	Portugiesisch (Brasilien)
0x0403	Katalanisch	0x0417	Rhaeto-Romanic
0x0404	Chinesisch (traditionell)	0x0418	Rumänisch
0x0405	Tschechisch	0x0419	Russisch
0x0406	Dänisch	0x041A	Croato-Serbian (Lateinisch)
0x0407	Deutsch	0x041B	Slowakisch
0x0408	Griechisch	0x041C	Albanisch
0x0409	Us-Amerikanisches Englisch	0x041D	Schwedisch
0x040A	Castilian Spanisch	0x041E	Thailändisch
0x040B	Finnisch	0x041F	Türkisch
0x040C	Französisch	0x0420	Urdu
0x040D	Hebräisch	0x0421	Bahasa
0x040E	Ungarisch	0x0804	Chinesisch (vereinfacht)
0x040F	Isländisch	0x0807	Schweizer Deutsch
0x0410	Italienisch	0x0809	U.K. Englisch
0x0411	Japanisch	0x080A	Spanisch (Mexiko)
0x0412	Koreanisch	0x080C	Belgisches Französisch
0x0413	Niederländisch	0x0C0C	Französisch (Kanada)
0x0414	Norwegisch? Bokmal	0x100C	Schweizer Französisch
0x0810	Schweizer Italienisch	0x0816	Portugiesisch (Portugal)
0x0813	Belgisches Niederländisches	0x081A	Serbo-Croatian (Kyrillisch)
0x0814	Norwegisch? Nynorsk

charsetID

Eine der folgenden Zeichensatzbezeichner.

Decimal	Hexadezimal	Zeichensatz
0	0000	7-Bit-ASCII
932	03A4	Japan (Schicht ? JIS X-0208)
949	03B5	Korea (Schicht ? KSC 5601)
950	03B6	Taiwan (Big5)
1200	04B0	Unicode
1250	04E2	Lateinisch-2 (Osteuropa)
1251	04E3	Kyrillisch
1252	04E4	Mehrsprachige
1253	04E5	Griechisch
1254	04E6	Türkisch
1255	04E7	Hebräisch
1256	04E8	Arabisch

Zeichenfolgenname

Eine der folgenden vordefinierten Namen.

Name	Beschreibung
Kommentare	Zusätzliche Informationen, die für Diagnosezwecke angezeigt werden sollen.
CompanyName	Unternehmen, das die Datei erstellt hat, z `Microsoft Corporation` . B. oder `Standard Microsystems Corporation, Inc.` diese Zeichenfolge ist erforderlich.
FileDescription	Dateibeschreibung, die benutzern angezeigt werden soll. Diese Zeichenfolge kann in einem Listenfeld angezeigt werden, wenn der Benutzer Dateien auswählt, die installiert werden sollen – `Keyboard Driver for AT-Style Keyboards`z. B. . Diese Zeichenfolge ist erforderlich.
FileVersion	Versionsnummer der Datei – z. B `3.10` . oder `5.00.RC2`. Diese Zeichenfolge ist erforderlich.
InternalName	Interner Name der Datei, wenn vorhanden, z. B. einen Modulnamen, wenn die Datei eine Dynamic-Link-Bibliothek ist. Wenn die Datei keinen internen Namen hat, sollte diese Zeichenfolge der ursprüngliche Dateiname ohne Erweiterung sein. Diese Zeichenfolge ist erforderlich.
LegalCopyright	Copyright-Hinweise, die für die Datei gelten. Dies sollte den vollständigen Text aller Benachrichtigungen, rechtliche Symbole, Copyright-Datumsangaben usw. enthalten. Diese Zeichenfolge ist optional.
LegalTrademarks	Marken und eingetragene Marken, die für die Datei gelten. Dies sollte den vollständigen Text aller Hinweise, rechtliche Symbole, Markennummern usw. umfassen. Diese Zeichenfolge ist optional.
OriginalFilename	Ursprünglicher Name der Datei, nicht einschließlich eines Pfads. Mit diesen Informationen kann eine Anwendung ermitteln, ob eine Datei von einem Benutzer umbenannt wurde. Das Format des Namens hängt vom Dateisystem ab, für das die Datei erstellt wurde. Diese Zeichenfolge ist erforderlich.
PrivateBuild	Informationen zu einer privaten Version der Datei – z. B `Built by TESTER1 on \\TESTBED`. . Diese Zeichenfolge sollte nur vorhanden sein, wenn VS_FF_PRIVATEBUILD im Fileflags-Parameter des Stammblocks angegeben wird.
ProductName	Name des Produkts, mit dem die Datei verteilt wird. Diese Zeichenfolge ist erforderlich.
ProductVersion	Version des Produkts, mit dem die Datei verteilt wird , `3.10` z. B. oder `5.00.RC2`. Diese Zeichenfolge ist erforderlich.
SpecialBuild	Text, der angibt, wie sich diese Version der Datei von der Standardversion unterscheidet , z `Private build for TESTER1 solving mouse problems on M250 and M250E computers`. B. . Diese Zeichenfolge sollte nur vorhanden sein, wenn VS_FF_SPECIALBUILD im Dateiflags-Parameter des Stammblocks angegeben wird.

Bestimmte Attribute werden auch zur Abwärtskompatibilität unterstützt. Weitere Informationen finden Sie unter "Common Resource Attributes".

Beispiele

Im folgenden Beispiel wird eine VERSIONINFO-Ressource definiert:

#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

Weitere Informationen

Verwenden von Versionsinformationen
Versionsinformationen