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
-
Konzeptionellen