VERSIONINFO-Ressource

Artikel
06/13/2023

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

Es gibt zwei Möglichkeiten, eine VERSIONINFO-Anweisung zu formatieren:

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

- oder -

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

Parameter

versionID

Ressourcenbezeichner für Versionsinformationen. Dieser Wert muss 1 sein.

fixed-info

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

-Anweisung.	BESCHREIBUNG
FILEVERSION-Version	Binäre Versionsnummer 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 version durch die DWORD-Wertedw1 und dw2 definiert ist, müssen sie daher wie folgt in der FILEVERSION-Anweisung angezeigt werden: `HIWORD(dw1)`, `LOWORD(dw1)`, `HIWORD(dw2)`, `LOWORD(dw2)`.
PRODUCTVERSION-Version	Binäre Versionsnummer für das Produkt, mit dem die Datei verteilt wird. Der Versionsparameter besteht aus zwei 32-Bit-Ganzzahlen, die durch vier 16-Bit-Ganzzahlen definiert sind. Weitere Informationen zur Version finden Sie in der FILEVERSION-Beschreibung .
FILEFLAGSMASKfileflagsmask	Gibt an, welche Bits in der FILEFLAGS-Anweisung gültig sind. Für 16-Bit-Windows ist dieser Wert 0x3f.
FILEFLAGS-Dateiflags	Attribute der Datei.
FILEOS-Dateios	Betriebssystem, für das diese Datei entworfen wurde. Der fileos-Parameter kann einer der Im Abschnitt Hinweise angegebenen Betriebssystemwerte sein.
FILETYPE-Dateityp	Allgemeiner Dateityp. Der Filetype-Parameter kann einer der Dateitypwerte sein, die im Abschnitt Hinweise aufgeführt sind.
FILESUBTYPE-Untertyp	Funktion der Datei. Der Untertypparameter ist null, es sei denn, der filetype-Parameter in der FILETYPE-Anweisung ist VFT_DRV, VFT_FONT oder VFT_VXD. Eine Liste der Dateiuntertypwerte finden Sie im Abschnitt Hinweise.

block-anweisung

Gibt mindestens einen Versionsinformationsblock 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:

fileflags

Eine Kombination der folgenden Werte.

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 identisch mit der ursprünglichen Versanddatei mit derselben Versionsnummer.
VS_FF_PRERELEASE	Die Datei ist eine Entwicklungsversion, kein kommerziell freigegebenes Produkt.
VS_FF_PRIVATEBUILD	Die Datei wurde nicht mit standard-Releaseprozeduren erstellt. Wenn dieser Wert angegeben wird, muss der StringFileInfo-Block eine PrivateBuild-Zeichenfolge enthalten.
VS_FF_SPECIALBUILD	Die Datei wurde vom ursprünglichen Unternehmen mithilfe von Standardveröffentlichungsverfahren erstellt, ist aber eine Variante der Standarddatei mit derselben Versionsnummer. Wenn dieser Wert angegeben wird, muss der StringFileInfo-Block eine SpecialBuild-Zeichenfolge enthalten.
VS_FFI_FILEFLAGSMASK	Eine Kombination aller vorangehenden Werte.

Fileos

Einer der folgenden Werte.

Wert	BESCHREIBUNG
VOS_UNKNOWN	Das Betriebssystem, für das die Datei entworfen 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 entwickelt, das mit MS-DOS ausgeführt wird.
VOS_DOS_WINDOWS32	Die Datei wurde für 32-Bit-Windows entwickelt, das mit MS-DOS ausgeführt wird.
VOS_NT_WINDOWS32	Die Datei wurde für 32-Bit-Windows entwickelt.

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

Filetype

Einer der folgenden Werte.

Wert	BESCHREIBUNG
VFT_UNKNOWN	Der Dateityp ist unbekannt.
VFT_APP	Die Datei enthält eine Anwendung.
VFT_DLL	Die Datei enthält eine DLL (Dynamic Link Library).
VFT_DRV	Die Datei enthält einen Gerätetreiber. Wenn der DateitypVFT_DRV ist, enthält der Untertyp eine spezifischere Beschreibung des Treibers.
VFT_FONT	Die Datei enthält eine Schriftart. Wenn der Dateityp VFT_FONT ist, enthält der Untertyp eine spezifischere Beschreibung der Schriftart.
VFT_VXD	Die Datei enthält ein virtuelles Gerät.
VFT_STATIC_LIB	Die Datei enthält eine Bibliothek mit statischem Link.

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

Untertyp

Zusätzliche Informationen zum Dateityp.

Wenn der DateitypVFT_DRV angibt, kann dieser Parameter einer 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 Versionsdruckertreiber.

Wenn der DateitypVFT_FONT angibt, kann dieser Parameter einer der folgenden Werte sein.

Wert	BESCHREIBUNG
VFT2_UNKNOWN	Der 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 der Dateityp VFT_VXD angibt, muss es sich bei diesem Parameter um den Bezeichner des virtuellen Geräts im Steuerungsblock für virtuelle Geräte handelt.

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

Langid

Einer 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.S. Englisch	0x041D	Schwedisch
0x040A	Kastilisch 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	Deutsch (Schweiz)
0x0410	Italienisch	0x0809	Uk.K. Englisch
0x0411	Japanisch	0x080A	Spanisch (Mexiko)
0x0412	Koreanisch	0x080C	Französisch (Belgien)
0x0413	Niederländisch	0x0C0C	Französisch (Kanada)
0x0414	Norwegisch? Bokmal	0x100C	Französisch (Schweiz)
0x0810	Schweizer Italienisch	0x0816	Portugiesisch (Portugal)
0x0813	Niederländisch	0x081A	Serbo-Croatian (Kyrillisch)
0x0814	Norwegisch? Nynorsk

charsetID

Einer der folgenden Zeichensatzbezeichner.

Decimal	Hexadezimal	Zeichensatz
0	0000	7-Bit-ASCII
932	03A4	Japan (Umschalten ? JIS X-0208)
949	03B5	Korea (Umschalten ? 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

Einer der folgenden vordefinierten Namen.

Name	BESCHREIBUNG
Kommentare	Zusätzliche Informationen, die für Diagnosezwecke angezeigt werden sollten.
CompanyName	Das Unternehmen, das die Datei erstellt hat, `Microsoft Corporation` z. 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 die zu installierenden Dateien auswählt, `Keyboard Driver for AT-Style Keyboards`z. B. . Diese Zeichenfolge ist erforderlich.
FileVersion	Versionsnummer der Datei, `3.10` z. B. oder `5.00.RC2`. Diese Zeichenfolge ist erforderlich.
InternalName	Interner Name der Datei, falls vorhanden, z. B. ein Modulname, wenn es sich bei der Datei um eine Bibliothek mit dynamischem Link handelt. Wenn die Datei keinen internen Namen hat, sollte diese Zeichenfolge der ursprüngliche Dateiname ohne Erweiterung sein. Diese Zeichenfolge ist erforderlich.
LegalCopyright	Urheberrechtshinweise, die für die Datei gelten. Dies sollte den vollständigen Text aller Hinweise, rechtlichen Symbole, Urheberrechtsdaten 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.
OriginalDateiname	Der ursprüngliche Name der Datei ohne Pfad. Mithilfe dieser 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, `Built by TESTER1 on \\TESTBED`z. B. . Diese Zeichenfolge sollte nur vorhanden sein, wenn VS_FF_PRIVATEBUILD im fileflags-Parameter des Stammblocks angegeben ist.
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, `Private build for TESTER1 solving mouse problems on M250 and M250E computers`z. B. . Diese Zeichenfolge sollte nur vorhanden sein, wenn VS_FF_SPECIALBUILD im fileflags-Parameter des Stammblocks angegeben ist.

Bestimmte Attribute werden auch aus Gründen der Abwärtskompatibilität unterstützt. Weitere Informationen finden Sie unter Allgemeine Ressourcenattribute.

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

Freigeben über

VERSIONINFO-Ressource

Parameter

Bemerkungen

Beispiele

Weitere Informationen

Feedback

Zusätzliche Ressourcen