Zeichenfolgenstruktur

Stellt die organization von Daten in einer Dateiversionsressource dar. Es enthält eine Zeichenfolge, die einen bestimmten Aspekt einer Datei beschreibt, z. B. die Version einer Datei, ihre Copyrighthinweise 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-Elements in Worten.

wType

Typ: WORD

Der Typ der Daten 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. Das szKey-Element kann mindestens einer der folgenden Werte sein. Diese Werte sind nur Richtlinien.

Kommentare

Das Value-Element 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

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

FileVersion

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

InternalName

Der Wert-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 Urheberrechtsvermerke, Marken und eingetragene Marken, die für die Datei gelten. Dies sollte den vollständigen Text aller Hinweise, rechtliche Symbole, Copyright-Datumsangaben, Markennummern usw. umfassen. In Englisch sollte diese Zeichenfolge das Format "Copyright Microsoft Corp. 1990 1994" aufweisen.

LegalTrademarks

Das Value-Mitglied beschreibt alle Marken und eingetragenen 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-Element identifiziert den ursprünglichen Namen der Datei, ohne dass ein Pfad enthalten ist. Dadurch kann eine Anwendung ermitteln, ob eine Datei von einem Benutzer umbenannt wurde. Dieser Name hat möglicherweise kein MS-DOS 8.3-Format, wenn die Datei spezifisch für ein Nicht-FAT-Dateisystem ist.

PrivateBuild

Der Wert-Member beschreibt, von wem, wo und warum diese private Version der Datei erstellt wurde. Diese Zeichenfolge sollte nur vorhanden sein, wenn das flag VS_FF_PRIVATEBUILD im dwFileFlags-Element der VS_FIXEDFILEINFO-Struktur festgelegt ist. Beispielsweise könnte Value "Built by OSCAR on \OSCAR2" (Erstellt von OSCAR auf \OSCAR2) sein.

Productname

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

Productversion

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

SpecialBuild

Das Value-Element beschreibt, wie sich diese Version der Datei von der normalen Version unterscheidet. Dieser Eintrag sollte nur vorhanden sein, wenn das flag VS_FF_SPECIALBUILD im dwFileFlags-Element der VS_FIXEDFILEINFO-Struktur festgelegt ist. Beispielsweise könnte Value "Privater Build für Olivetti beim Lösen von Mausproblemen auf M250- und M250E-Computern" sein.

Auffüllen

Typ: WORD

So viele 0 Wörter wie nötig, um das Value-Element an einer 32-Bit-Grenze auszurichten.

Wert

Typ: WORD

Eine Zeichenfolge, die mit Null beendet wird. Weitere Informationen finden Sie in der Beschreibung des szKey-Elements .

Bemerkungen

Diese Struktur ist keine echte C-Sprachstruktur, da sie Elemente mit variabler Länge enthält. Diese Struktur wurde ausschließlich erstellt, um die organization von Daten in einer Versionsressource darzustellen, und wird in keiner der Headerdateien angezeigt, die mit dem Windows Software Development Kit (SDK) ausgeliefert werden.

Eine String-Struktur kann den szKey-Wert aufweisen, z. B. "CompanyName" und den Wert "Microsoft Corporation". Eine andere String-Struktur mit demselben szKey-Wert könnte den Wert "Microsoft GmbH" enthalten. Dies kann auftreten, wenn die zweite String-Struktur einer StringTable-Struktur zugeordnet wurde, deren szKey-Wert 040704b0 ist, d. h. Deutsch/Unicode.

Anforderungen

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

Siehe auch

Referenz

Stringtable

VS_FIXEDFILEINFO

StringFileInfo

VS_VERSIONINFO

Konzept

Versionsinformationen