共用方式為


字串結構

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

語法

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

概念

版本資訊