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 [僅限桌面應用程式]

另請參閱

概念

資源

其他資源

CHARACTERISTICS 語句

LANGUAGE 語句

VERSION 語句