Structure de chaîne

Article
06/13/2023

Représente le organization de données dans une ressource de version de fichier. Il contient une chaîne qui décrit un aspect spécifique d’un fichier, par exemple la version d’un fichier, ses avis de copyright ou ses marques commerciales.

Syntaxe

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

Membres

wLength: Type : WORD; Longueur, en octets, de cette structure String .
wValueLength: Type : WORD; Taille, en mots, du membre Value .
wType: Type : WORD; Type de données dans la ressource de version. Ce membre est 1 si la ressource de version contient des données texte et 0 si la ressource de version contient des données binaires.
szKey: Type : WCHAR; Chaîne Unicode arbitraire. Le membre szKey peut être une ou plusieurs des valeurs suivantes. Ces valeurs sont uniquement des instructions.
Commentaires: Le membre Value contient toutes les informations supplémentaires qui doivent être affichées à des fins de diagnostic. Cette chaîne peut être d’une longueur arbitraire.
Companyname: Le membre Value identifie l’entreprise qui a produit le fichier. Par exemple, « Microsoft Corporation » ou « Standard Microsystems Corporation, Inc ».
FileDescription: Le membre Value décrit le fichier de manière à ce qu’il puisse être présenté aux utilisateurs. Cette chaîne peut être présentée dans une zone de liste lorsque l’utilisateur choisit les fichiers à installer. Par exemple, « Pilote de clavier pour les claviers de style AT » ou « Microsoft Word pour Windows ».
FileVersion: Le membre Value identifie la version de ce fichier. Par exemple, la valeur peut être « 3.00A » ou « 5.00.RC2 ».
InternalName: Le membre Value identifie le nom interne du fichier, le cas échéant. Par exemple, cette chaîne peut contenir le nom du module d’une DLL, un nom d’appareil virtuel pour un appareil virtuel Windows ou un nom d’appareil pour un pilote de périphérique MS-DOS.
LegalCopyright: Le membre Value décrit tous les avis de copyright, marques et marques déposées qui s’appliquent au fichier. Cela doit inclure le texte intégral de la totalité des mentions, symboles légaux, dates de copyright, numéros de marques, etc. En anglais, cette chaîne doit être au format « Copyright Microsoft Corp. 1990 1994 ».
LegalTrademarks: Le membre Value décrit toutes les marques commerciales et marques déposées qui s’appliquent au fichier. Cela doit inclure le texte intégral de la totalité des mentions, symboles légaux, numéros de marques, etc. En français, cette chaîne doit avoir le format « Windows est une marque de Microsoft Corporation ».
OriginalFilename: Le membre Value identifie le nom d’origine du fichier, sans inclure de chemin d’accès. Cela permet à une application de déterminer si un fichier a été renommé par un utilisateur. Ce nom peut ne pas être au format MS-DOS 8.3 si le fichier est spécifique à un système de fichiers non FAT.
PrivateBuild: Le membre Value décrit par qui, où et pourquoi cette version privée du fichier a été générée. Cette chaîne ne doit être présente que si l’indicateur VS_FF_PRIVATEBUILD est défini dans le membre dwFileFlags de la structure VS_FIXEDFILEINFO . Par exemple, Value peut être « Construit par OSCAR sur \OSCAR2 ».
Productname: Le membre Value identifie le nom du produit avec lequel ce fichier est distribué. Par exemple, cette chaîne peut être « Microsoft Windows ».
Productversion: Le membre Value identifie la version du produit avec lequel ce fichier est distribué. Par exemple, la valeur peut être « 3.00A » ou « 5.00.RC2 ».
SpecialBuild: Le membre Value décrit comment cette version du fichier diffère de la version normale. Cette entrée ne doit être présente que si l’indicateur VS_FF_SPECIALBUILD est défini dans le membre dwFileFlags de la structure VS_FIXEDFILEINFO . Par exemple, Value peut être « Build privé pour Olivetti qui résout les problèmes de souris sur les ordinateurs M250 et M250E ».

Remplissage

Type : WORD

Autant de mots zéro que nécessaire pour aligner le membre Value sur une limite 32 bits.

Valeur

Type : WORD

Chaîne sans fin. Pour plus d’informations, consultez la description du membre szKey .

Notes

Cette structure n’est pas une véritable structure en langage C, car elle contient des membres de longueur variable. Cette structure a été créée uniquement pour représenter la organization des données dans une ressource de version et n’apparaît dans aucun des fichiers d’en-tête fournis avec le Kit de développement logiciel (SDK) Windows.

Une structure string peut avoir une valeur szKey de, par exemple, « CompanyName » et une valeur de « Microsoft Corporation ». Une autre structure string avec la même valeur szKey peut contenir une valeur de « Microsoft GmbH ». Cela peut se produire si la deuxième structure string a été associée à une structure StringTable dont la valeur szKey est 040704b0, c’est-à-dire allemand/Unicode.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]

Voir aussi

Référence
StringTable
VS_FIXEDFILEINFO
StringFileInfo
VS_VERSIONINFO
Conceptuel
Informations sur la version

Partager via