文字列構造

[アーティクル]
06/13/2023

ファイルバージョンリソース内のデータのorganizationを表します。ファイルの特定の側面 (ファイルのバージョン、著作権情報、商標など) を記述する文字列が含まれています。

構文

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

メンバー

wLength: 種類: WORD; この String 構造体の長さ (バイト単位)。
wValueLength: 種類: WORD; Value メンバーのサイズ (単語単位)。
wType: 種類: WORD; バージョンリソース内のデータの種類。このメンバーは、バージョンリソースにテキストデータが含まれている場合は 1、バージョンリソースにバイナリデータが含まれている場合は 0 です。
szKey: 種類: WCHAR; 任意の Unicode 文字列。 szKey メンバーには、次の 1 つ以上の値を指定できます。これらの値はガイドラインのみです。
コメント: Value メンバーには、診断目的で表示する必要がある追加情報が含まれます。この文字列には任意の長さを指定できます。
Companyname: Value メンバーは、ファイルを作成した会社を識別します。たとえば、"Microsoft Corporation" や "Standard Microsystems Corporation, Inc" などです。
FileDescription: Value メンバーは、ユーザーに表示できるようにファイルを記述します。この文字列は、ユーザーがインストールするファイルを選択するときにリストボックスに表示される場合があります。たとえば、"AT スタイルキーボード用キーボードドライバー" や "Microsoft Word for Windows" などです。
FileVersion: Value メンバーは、このファイルのバージョンを識別します。たとえば、 Value には "3.00A" または "5.00.RC2" を指定できます。
InternalName: Value メンバーは、ファイルの内部名 (存在する場合) を識別します。たとえば、この文字列には、DLL のモジュール名、Windows 仮想デバイスの仮想デバイス名、MS-DOS デバイスドライバーのデバイス名を指定できます。
LegalCopyright: Value メンバーは、ファイルに適用されるすべての著作権表示、商標、および登録商標について説明します。これには、すべての通知の全文、法的な記号、著作権表示年、商標番号などが含まれます。英語では、この文字列は "Copyright Microsoft Corp. 1990 1994" の形式である必要があります。
LegalTrademarks: Value メンバーは、ファイルに適用されるすべての商標および登録商標について説明します。これには、すべての通知の全文、法的な記号、商標番号などが含まれます。英語では、この文字列は "Windows is a trademark of Microsoft Corporation" という書式になります。
OriginalFilename: Value メンバーは、パスを含まないファイルの元の名前を識別します。これにより、アプリケーションはファイルの名前がユーザーによって変更されたかどうかを判断できます。ファイルが FAT 以外のファイルシステムに固有の場合、この名前は MS-DOS 8.3 形式ではない可能性があります。
PrivateBuild: Value メンバーは、このプライベートバージョンのファイルがビルドされたユーザー、場所、および理由について説明します。この文字列は、VS_FIXEDFILEINFO構造体のdwFileFlags メンバーにVS_FF_PRIVATEBUILD フラグが設定されている場合にのみ存在する必要があります。たとえば、 Value は "\OSCAR2 上の OSCAR によって構築されました" と指定できます。
Productname: Value メンバーは、このファイルが配布される製品の名前を識別します。たとえば、この文字列には "Microsoft Windows" を指定できます。
ProductVersion: Value メンバーは、このファイルが配布される製品のバージョンを識別します。たとえば、 Value には "3.00A" または "5.00.RC2" を指定できます。
SpecialBuild: Value メンバーは、このバージョンのファイルが通常のバージョンとどのように異なるかを説明します。このエントリは、VS_FIXEDFILEINFO構造体のdwFileFlags メンバーにVS_FF_SPECIALBUILD フラグが設定されている場合にのみ存在する必要があります。たとえば、 Value は "M250 および M250E コンピューター上のマウスの問題を解決するための Olivetti のプライベートビルド" です。

パディング

種類: WORD

Value メンバーを 32 ビット境界に配置するために必要な数の 0 個の単語。

Value

種類: WORD

0 で終わる文字列。詳細については、 szKey メンバーの説明を参照してください。

解説

この構造体には可変長メンバーが含まれているため、この構造体は真の C 言語構造体ではありません。この構造は、バージョンリソース内のデータのorganizationのみを示すために作成されたもので、Windows Software Development Kit (SDK) に付属しているヘッダーファイルには表示されません。

String 構造体の szKey 値は、"CompanyName" や Value が "Microsoft Corporation" などです。同じ szKey 値を持つ別の String 構造体には、Value が "Microsoft GmbH" である可能性があります。これは、2 番目の String 構造体が、szKey 値が 040704b0 (ドイツ語/Unicode) の StringTable 構造体に関連付けられている場合に発生する可能性があります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]

次の方法で共有

文字列構造

構文

メンバー

解説

要件

関連項目

フィードバック

その他のリソース