Freigeben über


VERSIONINFO-Ressource

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 Keyboardsz. 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 \\TESTBEDz. 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 computersz. 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