文字列構造

  • [アーティクル]

ファイル バージョン リソース内のデータの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 [デスクトップ アプリのみ]

関連項目

参照

StringTable

VS_FIXEDFILEINFO

StringFileInfo

VS_VERSIONINFO

概念

バージョン情報