Ler em inglês

Compartilhar via


Estrutura de cadeia de caracteres

Representa a organização de dados em um recurso de versão de arquivo. Ele contém uma cadeia de caracteres que descreve um aspecto específico de um arquivo, por exemplo, a versão de um arquivo, seus avisos de direitos autorais ou suas marcas registradas.

Sintaxe

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

Membros

wLength

Tipo: WORD

O comprimento, em bytes, dessa estrutura String .

wValueLength

Tipo: WORD

O tamanho, em palavras, do membro Value .

wType

Tipo: WORD

O tipo de dados no recurso de versão. Esse membro será 1 se o recurso de versão contiver dados de texto e 0 se o recurso de versão contiver dados binários.

szKey

Tipo: WCHAR

Uma cadeia de caracteres Unicode arbitrária. O membro szKey pode ser um ou mais dos valores a seguir. Esses valores são apenas diretrizes.

Comentários

O membro Value contém informações adicionais que devem ser exibidas para fins de diagnóstico. Essa cadeia de caracteres pode ter um comprimento arbitrário.

Companyname

O membro Value identifica a empresa que produziu o arquivo. Por exemplo, "Microsoft Corporation" ou "Standard Microsystems Corporation, Inc.".

Filedescription

O membro Value descreve o arquivo de forma que ele possa ser apresentado aos usuários. Essa cadeia de caracteres pode ser apresentada em uma caixa de listagem quando o usuário está escolhendo arquivos para instalar. Por exemplo, "Driver de teclado para teclados no estilo AT" ou "Microsoft Word para Windows".

Fileversion

O membro Value identifica a versão desse arquivo. Por exemplo, Value pode ser "3.00A" ou "5.00.RC2".

Internalname

O membro Value identifica o nome interno do arquivo, se houver. Por exemplo, essa cadeia de caracteres pode conter o nome do módulo para uma DLL, um nome de dispositivo virtual para um dispositivo virtual Windows ou um nome de dispositivo para um driver de dispositivo MS-DOS.

LegalCopyright

O membro Value descreve todos os avisos de direitos autorais, marcas comerciais e marcas registradas que se aplicam ao arquivo. Isso deve incluir o texto completo de todos os avisos, símbolos legais, datas de direitos autorais, números de marca e assim por diante. Em inglês, essa cadeia de caracteres deve estar no formato "Copyright Microsoft Corp. 1990 1994".

Legaltrademarks

O membro Value descreve todas as marcas comerciais e marcas registradas que se aplicam ao arquivo. Isso deve incluir o texto completo de todos os avisos, símbolos legais, números de marca e assim por diante. Em inglês, essa cadeia de caracteres deve estar no formato "Windows is a trademark of Microsoft Corporation".

OriginalFilename

O membro Value identifica o nome original do arquivo, não incluindo um caminho. Isso permite que um aplicativo determine se um arquivo foi renomeado por um usuário. Esse nome poderá não ser o formato MS-DOS 8.3 se o arquivo for específico para um sistema de arquivos não FAT.

PrivateBuild

O membro Value descreve por quem, onde e por que essa versão privada do arquivo foi criada. Essa cadeia de caracteres só deverá estar presente se o sinalizador VS_FF_PRIVATEBUILD estiver definido no membro dwFileFlags da estrutura VS_FIXEDFILEINFO . Por exemplo, Value pode ser "Built by OSCAR on \OSCAR2".

Productname

O membro Value identifica o nome do produto com o qual esse arquivo é distribuído. Por exemplo, essa cadeia de caracteres pode ser "Microsoft Windows".

Productversion

O membro Value identifica a versão do produto com a qual esse arquivo é distribuído. Por exemplo, Value pode ser "3.00A" ou "5.00.RC2".

Specialbuild

O membro Value descreve como essa versão do arquivo difere da versão normal. Essa entrada só deverá estar presente se o sinalizador VS_FF_SPECIALBUILD estiver definido no membro dwFileFlags da estrutura VS_FIXEDFILEINFO . Por exemplo, Value pode ser "Build privado para olivetti resolver problemas do mouse em computadores M250 e M250E".

Preenchimento

Tipo: WORD

Quantas palavras zero forem necessárias para alinhar o membro Value em um limite de 32 bits.

Valor

Tipo: WORD

Uma cadeia de caracteres terminada em zero. Confira a descrição do membro szKey para obter mais informações.

Comentários

Essa estrutura não é uma estrutura de linguagem C verdadeira porque contém membros de comprimento variável. Essa estrutura foi criada exclusivamente para representar a organização dos dados em um recurso de versão e não aparece em nenhum dos arquivos de cabeçalho enviados com o SDK (Software Development Kit) do Windows.

Uma estrutura String pode ter um valor szKey de, por exemplo, "CompanyName" e um Valor de "Microsoft Corporation". Outra estrutura String com o mesmo valor szKey pode conter um Valor de "Microsoft GmbH". Isso poderá ocorrer se a segunda estrutura String estiver associada a uma estrutura StringTable cujo valor szKey seja 040704b0, ou seja, alemão/Unicode.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]

Confira também

Referência

Stringtable

VS_FIXEDFILEINFO

StringFileInfo

VS_VERSIONINFO

Conceitual

Informações sobre versão