Zeichenfolgenstruktur

Artikel
06/13/2023

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

Freigeben über