RESOURCEHEADER 構造体

[アーティクル]
06/13/2023

リソースヘッダー自体と、このリソースに固有のデータに関する情報が含まれます。この構造体には可変長メンバーが含まれているため、この構造体は真の 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

特定のリソースを識別する名前。 TYPE メンバーと同様に、NAME メンバーには数値または null で終わる Unicode 文字列を指定できます。 Name または Ordinal 型のメンバーの説明については、次の「解説」セクションを参照してください。

TYPE メンバーと NAME メンバーには WORD データが含まれているため、DWORD の配置にパディングを追加する必要はありません。ただし、ヘッダーの残りの部分を DWORD 境界に合わせるために、NAME メンバーの後に埋め込みの WORD を追加する必要がある場合があります。

DataVersion

型: DWORD

定義済みのリソースデータバージョン。これにより、アプリケーションで使用するリソースデータのバージョンが決まります。

MemoryFlags

種類: WORD

リソースの状態を記述できる属性フラグのセット。内の修飾子。RC スクリプトファイルは、これらの属性をリソースに割り当てます。スクリプト識別子は、次のフラグ値を割り当てることができます。

アプリケーションでは、これらの属性は使用されません。属性は、既存のスクリプトとの下位互換性のためにスクリプトで許可されていますが、無視されます。リソースは、対応するモジュールが読み込まれるときに読み込まれ、モジュールがアンロードされるときに解放されます。

MOVEABLE (0x0010)

修正済み (~MOVEABLE)

PURE (0x0020)

不純 (~PURE)

PRELOAD (0x0040)

LOADONCALL (~PRELOAD)

DISCARDABLE (0x1000)

LanguageId

種類: WORD

リソースまたはリソースのセットの言語。オプションの LANGUAGE リソース定義ステートメントを使用して、このメンバーの値を設定します。パラメーターは Winnt.h ファイルの定数です。

各リソースには言語識別子が含まれているため、システムまたはアプリケーションは、システムの現在のロケールに適した言語を選択できます。リソース内の文字列の言語でのみ異なる同じ型と名前のリソースが複数ある場合は、それぞれに LanguageId を 指定する必要があります。

Version

型: DWORD

ツールがリソースファイルの読み取りと書き込みに使用できるリソースデータのユーザー定義バージョン番号。オプションの VERSION リソース定義ステートメントを使用して、この値を設定します。

特性

型: DWORD

ツールがリソースファイルの読み取りと書き込みに使用できるリソースに関するユーザー定義情報を指定します。オプションの CHARACTERISTICS リソース定義ステートメントを使用して、この値を設定します。

解説

変数型メンバーは Name または Ordinal メンバーと呼ばれ、識別子が表示されるリソースファイル内のほとんどの場所で使用されます。 Name 型または序数型メンバーの最初の WORD は、メンバーが数値か文字列かを示します。メンバーの最初の WORD が、無効な Unicode 文字である0xffff値と等しい場合、次の WORD は型番号になります。それ以外の場合、メンバーには Unicode 文字列が含まれており、メンバーの最初の WORD は名前文字列の最初の文字です。リソース定義ステートメントの詳細については、「リソース定義ステートメント」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]

次の方法で共有

RESOURCEHEADER 構造体

構文

メンバー

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース