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