字串結構

表示檔案版本資源中的資料組織。 它包含描述檔案特定層面的字串，例如檔案版本、著作權聲明或其商標。

語法

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成員可以是下列一或多個值。 這些值只是指導方針。

評論

Value成員包含任何應該針對診斷目的顯示的額外資訊。 此字串可以是任意長度。

CompanyName

Value成員會識別產生檔案的公司。 例如，「Microsoft Corporation」 或 「Standard Microsystems Corporation， Inc.」

FileDescription

Value成員會以可向使用者呈現的方式描述檔案。 當使用者選擇要安裝的檔案時，此字串可能會顯示在清單方塊中。 例如，「AT 樣式鍵盤的鍵盤驅動程式」或「適用于 Windows 的 Microsoft Word」。

FileVersion

Value成員會識別此檔案的版本。 例如， Value 可以是 「3.00A」 或 「5.00.RC2」。

InternalName

如果檔案存在， Value 成員會識別檔案的內部名稱。 例如，此字串可能包含 DLL 的模組名稱、Windows 虛擬裝置的虛擬裝置名稱，或 MS-DOS 設備磁碟機的裝置名稱。

LegalCopyright

Value成員描述套用至檔案的所有著作權聲明、商標和注冊商標。 這應包括所有注意事項全文、法律符號、版權日期、商標登錄編號等等。 在英文中，此字串的格式應該是 「Copyright Microsoft Corp. 1990 1994」。

LegalMarks

Value成員描述套用至檔案的所有商標和注冊商標。 這應包括所有注意事項全文、法律符號、商標登錄編號等等。 此段文字的英文格式應為 "Windows is a trademark of Microsoft Corporation"。

OriginalFilename

Value成員會識別檔案的原始名稱，不包括路徑。 這可讓應用程式判斷檔案是否已由使用者重新命名。 如果檔案是非 FAT 檔案系統特有的，這個名稱可能不是 MS-DOS 8.3 格式。

PrivateBuild

Value成員會描述建置此檔案私人版本的人員、位置及原因。 只有當VS_FF_PRI加值稅EBUILD旗標是在VS_FIXEDFILEINFO結構的dwFileFlags成員中設定時，才應該存在這個字串。 例如， 值 可能是「由 OSCAR 在 \OSCAR2 上建置」。

ProductName

Value成員會識別此檔案所散發的產品名稱。 例如，此字串可以是 「Microsoft Windows」。

ProductVersion

Value成員會識別此檔案散發的產品版本。 例如， Value 可以是 「3.00A」 或 「5.00.RC2」。

SpecialBuild

Value成員描述此版本的檔案與一般版本有何不同。 只有當VS_FF_SPECIALBUILD旗標是在VS_FIXEDFILEINFO結構的dwFileFlags成員中設定時，才應該存在這個專案。 例如， Value 可能是「用於在 M250 和 M250E 電腦上解決滑鼠問題的私人組建」。

填補

類型： WORD

在 32 位界限上對齊 Value 成員所需的零個字數。

值

類型： WORD

以零結尾的字串。 如需詳細資訊，請參閱 szKey 成員描述。

備註

此結構不是真正的 C 語言結構，因為它包含可變長度的成員。 此結構僅是為了描述版本資源中的資料組織，而且不會出現在隨附于 Windows 軟體發展工具組 (SDK) 的任何標頭檔中。

String結構可能會有szKey值，例如 「CompanyName」和 Value 為「Microsoft Corporation」。 另一個具有相同szKey值的String結構可能包含 「Microsoft GmbH」的值。 如果第二個String結構與szKey值為 040704b0 且為德文/Unicode 的StringTable結構相關聯，就可能發生此情況。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]

另請參閱

參考

StringTable

VS_FIXEDFILEINFO

StringFileInfo

VS_VERSIONINFO

概念

版本資訊