RESOURCEHEADER 結構
包含資源標頭本身和此資源專屬資料的相關資訊。 此結構不是真正的 C 語言結構,因為它包含可變長度的成員。 此處提供的結構定義僅供說明之用;它不存在於任何標準標頭檔中。
語法
typedef struct {
DWORD DataSize;
DWORD HeaderSize;
DWORD TYPE;
DWORD NAME;
DWORD DataVersion;
WORD MemoryFlags;
WORD LanguageId;
DWORD Version;
DWORD Characteristics;
} RESOURCEHEADER;
成員
-
DataSize
-
類型: DWORD
-
此特定資源之資源標頭後面的資料大小,以位元組為單位。 它不包含此資源與資源檔中後面任何資源之間的任何檔案填補。
-
HeaderSize
-
類型: DWORD
-
下列資源標頭資料的大小,以位元組為單位。
-
TYPE
-
類型: DWORD
-
資源類型。 TYPE成員可以是數值或以 Null 結尾的 Unicode 字串,指定類型的名稱。 如需 Name 或 Ordinal 類型成員的描述,請參閱下列一節。
如果 TYPE 成員是數值,它可以指定標準或使用者定義的資源類型。 如果成員是字串,則它是使用者定義的資源類型。 如需預先定義的資源類型清單,請參閱 資源類型。
小於 256 的值會保留供系統使用。
-
名稱
-
類型: DWORD
-
識別特定資源的名稱。 NAME成員,例如TYPE成員,可以是數值或 Null 終止的 Unicode 字串。 如需 Name 或 Ordinal 類型成員的描述,請參閱下列一節。
您不需要在TYPE和NAME成員之間新增DWORD對齊的邊框間距,因為它們包含WORD資料。 不過,您可能需要在NAME成員後面新增一個邊框間距的WORD,以對齊DWORD界限上的其餘標頭。
-
DataVersion
-
類型: DWORD
-
預先定義的資源資料版本。 這會決定應用程式應該使用的資源資料版本。
-
MemoryFlags
-
類型: WORD
-
一組可描述資源狀態的屬性旗標。 中的修飾詞。RC 指令檔會將這些屬性指派給資源。 腳本識別碼可以指派下列旗標值。
應用程式不會使用這些屬性中的任何一個。 腳本中允許屬性與現有腳本回溯相容性,但會予以忽略。 載入對應的模組時會載入資源,並在卸載模組時釋出。
-
MOVEABLE (0x0010)
-
已修正 (~MOVEABLE)
-
PURE (0x0020)
-
IMPURE (~PURE)
-
PRELOAD (0x0040)
-
LOADONCALL (~PRELOAD)
-
可捨棄 (0x1000)
LanguageId
類型: WORD
資源或資源集的語言。 使用選擇性 LANGUAGE 資源定義語句設定這個成員的值。 參數是 Winnt.h 檔案中的常數。
每個資源都包含語言識別項,讓系統或應用程式可以選取適合系統目前地區設定的語言。 如果多個資源的類型和名稱只與資源內字串的語言不同,您必須為每個資源指定 LanguageId 。
版本
類型: DWORD
工具可用來讀取和寫入資源檔之資源資料的使用者定義版本號碼。 使用選擇性 的 VERSION 資源定義語句來設定此值。
特性
類型: DWORD
指定工具可用來讀取和寫入資源檔之資源的使用者定義資訊。 使用選擇性 的 CHARACTERISTICS 資源定義語句來設定此值。
備註
變數類型成員稱為 Name 或 Ordinal 成員,而且會用於資源檔中出現識別碼的大部分位置。 Name或Ordinal類型成員的第一個WORD會指出成員是數值還是字串。 如果成員中的第一個 WORD 等於值0xffff,這是不正確 Unicode 字元,則下列 WORD 是類型數位。 否則,成員會包含 Unicode 字串,而成員中的第一個 WORD 是名稱字串中的第一個字元。 如需資源定義語句的其他資訊,請參閱 Resource-Definition 語句。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
另請參閱
-
概念
-
其他資源