Struttura stringa

Rappresenta l'organizzazione dei dati in una risorsa di versione file. Contiene una stringa che descrive un aspetto specifico di un file, ad esempio la versione di un file, le relative note sul copyright o i relativi marchi.

Sintassi

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

Members

wLength

Tipo: WORD

Lunghezza, in byte, di questa struttura String .

wValueLength

Tipo: WORD

Dimensione, in parole, del membro Value .

wType

Tipo: WORD

Tipo di dati nella risorsa della versione. Questo membro è 1 se la risorsa di versione contiene dati di testo e 0 se la risorsa della versione contiene dati binari.

szKey

Tipo: WCHAR

Stringa Unicode arbitraria. Il membro szKey può essere uno o più dei valori seguenti. Questi valori sono solo linee guida.

Commenti

Il membro Value contiene eventuali informazioni aggiuntive che devono essere visualizzate a scopo di diagnostica. Questa stringa può essere una lunghezza arbitraria.

Companyname

Il membro Value identifica l'azienda che ha prodotto il file. Ad esempio, "Microsoft Corporation" o "Standard Microsystems Corporation, Inc".

FileDescription

Il membro Value descrive il file in modo che possa essere presentato agli utenti. Questa stringa può essere presentata in una casella di riepilogo quando l'utente sceglie i file da installare. Ad esempio, "Driver da tastiera per tastiere in stile AT" o "Microsoft Word for Windows".

FileVersion

Il membro Value identifica la versione di questo file. Ad esempio, il valore potrebbe essere "3.00A" o "5.00.RC2".

InternalName

Il membro Value identifica il nome interno del file, se presente. Ad esempio, questa stringa potrebbe contenere il nome del modulo per una DLL, un nome di dispositivo virtuale per un dispositivo Windows o un nome del dispositivo per un driver di dispositivo MS-DOS.

LegalCopyright

Il membro Value descrive tutti gli avvisi di copyright, i marchi e i marchi registrati che si applicano al file. Deve includere il testo completo di tutte le comunicazioni, i simboli legali, le date di copyright, i numeri dei marchi e così via. In inglese, questa stringa deve essere nel formato "Copyright Microsoft Corp. 1990 1994".

LegalTrademarks

Il membro Value descrive tutti i marchi e i marchi registrati che si applicano al file. Deve includere il testo completo di tutte le comunicazioni, i simboli legali, i numeri dei marchi e così via. In inglese questa stringa dovrebbe essere "Windows is a trademark of Microsoft Corporation".

OriginalFilename

Il membro Value identifica il nome originale del file, non incluso un percorso. Ciò consente a un'applicazione di determinare se un file è stato rinominato da un utente. Questo nome potrebbe non essere MS-DOS 8.3-format se il file è specifico di un file system non FAT.

PrivateBuild

Il membro Value descrive chi, dove e perché è stata compilata questa versione privata del file. Questa stringa deve essere presente solo se il flag di VS_FF_PRIVATEBUILD è impostato nel membro dwFileFlags della struttura VS_FIXEDFILEINFO . Ad esempio, Value può essere "Costruito da OSCAR su \OSCAR2".

Productname

Il membro Value identifica il nome del prodotto con cui viene distribuito questo file. Ad esempio, questa stringa potrebbe essere "Microsoft Windows".

Productversion

Il membro Value identifica la versione del prodotto con cui viene distribuito questo file. Ad esempio, il valore potrebbe essere "3.00A" o "5.00.RC2".

SpecialBuild

Il membro Value descrive come questa versione del file differisce dalla versione normale. Questa voce deve essere presente solo se il flag di VS_FF_SPECIALBUILD è impostato nel membro dwFileFlags della struttura VS_FIXEDFILEINFO . Ad esempio, Value può essere "Build privata per Olivetti che risolve i problemi del mouse nei computer M250 e M250E".

Riempimento

Tipo: WORD

Numero di parole zero necessarie per allineare il membro Value su un limite a 32 bit.

Valore

Tipo: WORD

Stringa con terminazione zero. Per altre informazioni, vedere la descrizione del membro szKey .

Commenti

Questa struttura non è una vera struttura del linguaggio C perché contiene membri a lunghezza variabile. Questa struttura è stata creata esclusivamente per rappresentare l'organizzazione dei dati in una risorsa di versione e non viene visualizzata in nessuno dei file di intestazione forniti con Windows Software Development Kit (SDK).

Una struttura String può avere un valore szKey di, ad esempio "CompanyName" e un valore di "Microsoft Corporation". Un'altra struttura String con lo stesso valore szKey potrebbe contenere un valore di "Microsoft GmbH". Ciò potrebbe verificarsi se la seconda struttura String era associata a una struttura StringTable il cui valore szKey è 040704b0, ovvero tedesco/Unicode.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]

Vedi anche

Riferimento

Stringtable

VS_FIXEDFILEINFO

StringFileInfo

VS_VERSIONINFO

Informazioni concettuali

Informazioni sulla versione