Estructura de cadena

Artículo
06/13/2023

Representa la organización de los datos en un recurso de versión de archivo. Contiene una cadena que describe un aspecto específico de un archivo, por ejemplo, la versión de un archivo, sus avisos de copyright o sus marcas comerciales.

Sintaxis

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

Miembros

wLength: Tipo: WORD; Longitud, en bytes, de esta estructura string .
wValueLength: Tipo: WORD; Tamaño, en palabras, del miembro Value .
wType: Tipo: WORD; Tipo de datos en el recurso de versión. Este miembro es 1 si el recurso de versión contiene datos de texto y 0 si el recurso de versión contiene datos binarios.
szKey: Tipo: WCHAR; Cadena Unicode arbitraria. El miembro szKey puede ser uno o varios de los valores siguientes. Estos valores son solo directrices.
Comentarios: El miembro Value contiene información adicional que se debe mostrar con fines de diagnóstico. Esta cadena puede ser una longitud arbitraria.
Companyname: El miembro Value identifica la empresa que generó el archivo. Por ejemplo, "Microsoft Corporation" o "Standard Microsystems Corporation, Inc."
FileDescription: El miembro Value describe el archivo de tal forma que se pueda presentar a los usuarios. Esta cadena se puede presentar en un cuadro de lista cuando el usuario elige archivos para instalar. Por ejemplo, "Controlador de teclado para teclados de estilo AT" o "Microsoft Word para Windows".
FileVersion: El miembro Value identifica la versión de este archivo. Por ejemplo, Value podría ser "3.00A" o "5.00.RC2".
InternalName: El miembro Value identifica el nombre interno del archivo, si existe uno. Por ejemplo, esta cadena podría contener el nombre del módulo para un archivo DLL, un nombre de dispositivo virtual para un dispositivo virtual Windows o un nombre de dispositivo para un controlador de dispositivo MS-DOS.
LegalCopyright: El miembro Value describe todos los avisos de copyright, marcas comerciales y marcas registradas que se aplican al archivo. Esto debe incluir el texto completo de todos los avisos, símbolos legales, fechas de copyright, números de marcas comerciales, etc. En inglés, esta cadena debe tener el formato "Copyright Microsoft Corp. 1990 1994".
LegalTrademarks: El miembro Value describe todas las marcas comerciales y marcas registradas que se aplican al archivo. Esto debe incluir el texto completo de todos los avisos, símbolos legales, números de marcas comerciales, etc. En inglés, esta cadena debe tener el formato "Windows es una marca comercial de Microsoft Corporation".
OriginalFilename: El miembro Value identifica el nombre original del archivo, no incluida una ruta de acceso. Esto permite a una aplicación determinar si un usuario ha cambiado el nombre de un archivo. Es posible que este nombre no tenga formato MS-DOS 8.3 si el archivo es específico de un sistema de archivos que no es FAT.
PrivateBuild: El miembro Value describe por quién, dónde y por qué se ha compilado esta versión privada del archivo. Esta cadena solo debe estar presente si la marca VS_FF_PRIVATEBUILD está establecida en el miembro dwFileFlags de la estructura VS_FIXEDFILEINFO . Por ejemplo, Value podría ser "Built by OSCAR on \OSCAR2".
Productname: El miembro Value identifica el nombre del producto con el que se distribuye este archivo. Por ejemplo, esta cadena podría ser "Microsoft Windows".
Productversion: El miembro Value identifica la versión del producto con la que se distribuye este archivo. Por ejemplo, Value podría ser "3.00A" o "5.00.RC2".
SpecialBuild: El miembro Value describe cómo difiere esta versión del archivo de la versión normal. Esta entrada solo debe estar presente si la marca VS_FF_SPECIALBUILD está establecida en el miembro dwFileFlags de la estructura VS_FIXEDFILEINFO . Por ejemplo, Value podría ser "Compilación privada para la resolución de problemas del mouse de Olivetti en equipos M250 y M250E".

Relleno

Tipo: WORD

Tantas palabras cero como sea necesario para alinear el miembro Value en un límite de 32 bits.

Valor

Tipo: WORD

Cadena terminada en cero. Consulte la descripción del miembro szKey para obtener más información.

Observaciones

Esta estructura no es una verdadera estructura del lenguaje C porque contiene miembros de longitud variable. Esta estructura se creó únicamente para representar la organización de datos en un recurso de versión y no aparece en ninguno de los archivos de encabezado enviados con el Kit de desarrollo de software (SDK) de Windows.

Una estructura String puede tener un valor szKey de, por ejemplo, "CompanyName" y un valor de "Microsoft Corporation". Otra estructura String con el mismo valor szKey podría contener un valor de "Microsoft GmbH". Esto puede ocurrir si la segunda estructura String estaba asociada a una estructura StringTable cuyo valor szKey es 040704b0 es decir, Alemán/Unicode.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]

Consulte también

Referencia
StringTable
VS_FIXEDFILEINFO
StringFileInfo
VS_VERSIONINFO
Conceptual
Información de versión