Zeichenfolgenstruktur

Stellt die Organisation von Daten in einer Dateiversionsressource dar. Sie enthält eine Zeichenfolge, die einen bestimmten Aspekt einer Datei beschreibt, z. B. die Version einer Datei, ihre Urheberrechtshinweise oder ihre Marken.

Syntax

typedef struct {
  WORD  wLength;
  WORD  wValueLength;
  WORD  wType;
  WCHAR szKey;
  WORD  Padding;
  WORD  Value;
} String;

Member

wLength

Typ: WORD

Die Länge dieser Zeichenfolgenstruktur in Bytes.

wValueLength

Typ: WORD

Die Größe des Value-Members in Wörtern.

wType

Typ: WORD

Der Datentyp in der Versionsressource. Dieser Member ist 1, wenn die Versionsressource Textdaten enthält, und 0, wenn die Versionsressource Binärdaten enthält.

szKey

Typ: WCHAR

Eine beliebige Unicode-Zeichenfolge. Der szKey-Member kann einer oder mehrere der folgenden Werte sein. Diese Werte sind nur Richtlinien.

Kommentare

Das Value-Member enthält alle zusätzlichen Informationen, die zu Diagnosezwecken angezeigt werden sollen. Diese Zeichenfolge kann eine beliebige Länge haben.

Companyname

Das Value-Mitglied identifiziert das Unternehmen, das die Datei erstellt hat. Beispiel: "Microsoft Corporation" oder "Standard Microsystems Corporation, Inc."

FileDescription

Der Value-Member beschreibt die Datei so, dass sie Benutzern präsentiert werden kann. Diese Zeichenfolge kann in einem Listenfeld angezeigt werden, wenn der Benutzer zu installierende Dateien auswählt. Beispiel: "Tastaturtreiber für Tastaturen im AT-Stil" oder "Microsoft Word für Windows".

FileVersion

Der Value-Member identifiziert die Version dieser Datei. Der Wert kann beispielsweise "3.00A" oder "5.00.RC2" sein.

InternalName

Das Value-Member identifiziert den internen Namen der Datei, sofern vorhanden. Diese Zeichenfolge kann beispielsweise den Modulnamen für eine DLL, einen Namen eines virtuellen Geräts für ein virtuelles Windows-Gerät oder einen Gerätenamen für einen MS-DOS-Gerätetreiber enthalten.

LegalCopyright

Das Value-Mitglied beschreibt alle Urheberrechtshinweise, Marken und registrierten Marken, die für die Datei gelten. Dies sollte den vollständigen Text aller Hinweise, rechtliche Symbole, Copyright-Datumsangaben, Markennummern usw. umfassen. Auf Englisch sollte diese Zeichenfolge das Format "Copyright Microsoft Corp. 1990 1994" haben.

Legal Zustempel

Das Value-Mitglied beschreibt alle Marken und registrierten Marken, die für die Datei gelten. Dies sollte den vollständigen Text aller Hinweise, rechtliche Symbole, Markennummern usw. umfassen. Im Deutschen sollte diese Zeichenfolge das folgende Format aufweisen: "Windows ist eine Marke der Microsoft Corporation".

OriginalFilename

Das Value-Member identifiziert den ursprünglichen Namen der Datei, ohne einen Pfad. Dadurch kann eine Anwendung bestimmen, ob eine Datei von einem Benutzer umbenannt wurde. Dieser Name darf nicht im MS-DOS 8.3-Format vorliegen, wenn die Datei für ein Nicht-FAT-Dateisystem spezifisch ist.

PrivateBuild

Der Value-Member beschreibt, von wem, wo und warum diese private Version der Datei erstellt wurde. Diese Zeichenfolge sollte nur vorhanden sein, wenn das VS _ FF _ PRIVATEBUILD-Flag im dwFileFlags-Member der VS _ FIXEDFILEINFO-Struktur festgelegt ist. Der Wert könnte z. B. "Built by WIES \ onNOM2" sein.

Productname

Das Value-Member identifiziert den Namen des Produkts, mit dem diese Datei verteilt wird. Diese Zeichenfolge könnte beispielsweise "Microsoft Windows" sein.

Productversion

Der Value-Member identifiziert die Version des Produkts, mit dem diese Datei verteilt wird. Der Wert kann beispielsweise "3.00A" oder "5.00.RC2" sein.

SpecialBuild

Der Value-Member beschreibt, wie sich diese Version der Datei von der normalen Version unterscheidet. Dieser Eintrag sollte nur vorhanden sein, wenn das VS _ FF _ SPECIALBUILD-Flag im dwFileFlags-Member der VS _ FIXEDFILEINFO-Struktur festgelegt ist. Der Wert könnte z. B. "Privater Build für Die Lösung von Mausproblemen auf M250- und M250E-Computern" sein.

Auffüllen

Typ: WORD

So viele Nullwörter wie erforderlich, um das Value-Member an einer 32-Bit-Grenze auszurichten.

Wert

Typ: WORD

Eine auf 0 (null) beendete Zeichenfolge. Weitere Informationen finden Sie in der SzKey-Memberbeschreibung.

Hinweise

Diese Struktur ist keine echte C-Sprachstruktur, da sie Member variabler Länge enthält. Diese Struktur wurde ausschließlich zur Darstellung der Organisation von Daten in einer Versionsressource erstellt und wird nicht in den Headerdateien angezeigt, die im Lieferumfang des Windows Software Development Kit (SDK) enthalten sind.

Eine String-Struktur kann den szKey-Wert z. B. "CompanyName" und den Wert "Microsoft Corporation" haben. Eine andere String-Struktur mit dem gleichen szKey-Wert kann den Wert "Microsoft GmbH" enthalten. This might occur if the second String structure were associated with a StringTable structure whose szKey value is 040704b0 that is, German/Unicode.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]

Weitere Informationen

Referenz

Stringtable

VS _ FIXEDFILEINFO

StringFileInfo

VS _ VERSIONINFO

Konzeptionellen

Versionsinformationen