RESOURCEHEADER-Struktur

Enthält Informationen zum Ressourcenheader selbst und zu den für diese Ressource spezifischen Daten. Diese Struktur ist keine echte C-Sprachstruktur, da sie Elemente mit variabler Länge enthält. Die hier bereitgestellte Strukturdefinition dient nur zur Erklärung. es ist in keiner Standardheaderdatei vorhanden.

Syntax

typedef struct {
  DWORD DataSize;
  DWORD HeaderSize;
  DWORD TYPE;
  DWORD NAME;
  DWORD DataVersion;
  WORD  MemoryFlags;
  WORD  LanguageId;
  DWORD Version;
  DWORD Characteristics;
} RESOURCEHEADER;

Member

DataSize

Art: DWORD

Die Größe der Daten in Bytes, die dem Ressourcenheader für diese bestimmte Ressource folgen. Sie enthält keinen Dateispeicher zwischen dieser Ressource und jeder Ressource, die ihr in der Ressourcendatei folgt.

HeaderSize

Art: DWORD

Die Größe der folgenden Ressourcenheaderdaten in Bytes.

TYPE

Art: DWORD

Der Ressourcentyp. Das TYPE-Element kann entweder ein numerischer Wert oder eine Unicode-Zeichenfolge mit Null-Beendigung sein, die den Namen des Typs angibt. Im folgenden Abschnitt Hinweise finden Sie eine Beschreibung von Membern vom Typ Name oder Ordinal .

Wenn das TYPE-Element ein numerischer Wert ist, kann er entweder einen Standard- oder einen benutzerdefinierten Ressourcentyp angeben. Wenn das Element eine Zeichenfolge ist, handelt es sich um einen benutzerdefinierten Ressourcentyp. Eine Liste der vordefinierten Ressourcentypen finden Sie unter Ressourcentypen.

Werte unter 256 sind für die Systemverwendung reserviert.

NAME

Art: DWORD

Ein Name, der die jeweilige Ressource identifiziert. Das NAME-Element kann wie das TYPE-Element entweder ein numerischer Wert oder eine Unicode-Zeichenfolge mit Null-Endung sein. Im folgenden Abschnitt Hinweise finden Sie eine Beschreibung von Membern vom Typ Name oder Ordinal .

Sie müssen keine Auffüllung für die DWORD-Ausrichtung zwischen den MEMBERN TYPE und NAME hinzufügen, da sie WORD-Daten enthalten. Möglicherweise müssen Sie jedoch einen WORD-Bereich nach dem NAME-Member hinzufügen, um den Rest des Headers an DWORD-Grenzen auszurichten.

DataVersion

Art: DWORD

Eine vordefinierte Ressourcendatenversion. Dadurch wird bestimmt, welche Version der Ressourcendaten die Anwendung verwenden soll.

MemoryFlags

Typ: WORD

Eine Reihe von Attributflags, die den Zustand der Ressource beschreiben können. Modifizierer in . Die RC-Skriptdatei weisen Diese Attribute der Ressource zu. Die Skriptbezeichner können die folgenden Flagwerte zuweisen.

Anwendungen verwenden keines dieser Attribute. Die Attribute sind im Skript aus Gründen der Abwärtskompatibilität mit vorhandenen Skripts zulässig, werden jedoch ignoriert. Ressourcen werden beim Laden des entsprechenden Moduls geladen und beim Entladen des Moduls freigegeben.

MOVEABLE (0x0010)

BEHOBEN (~MOVEABLE)

PURE (0x0020)

UNREIN (~PURE)

PRELOAD (0x0040)

LOADONCALL (~PRELOAD)

VERWERFBAR (0x1000)

Languageid

Typ: WORD

Die Sprache für die Ressource oder gruppe von Ressourcen. Legen Sie den Wert für dieses Element mit der optionalen LANGUAGE-Ressourcendefinitionsanweisung fest. Bei den Parametern handelt es sich um Konstanten aus der Datei Winnt.h.

Jede Ressource enthält einen Sprachbezeichner, damit das System oder die Anwendung eine Sprache auswählen kann, die für das aktuelle Gebietsschema des Systems geeignet ist. Wenn mehrere Ressourcen desselben Typs und namens vorhanden sind, die sich nur in der Sprache der Zeichenfolgen innerhalb der Ressourcen unterscheiden, müssen Sie eine LanguageId für jede ressource angeben.

Version

Art: DWORD

Eine benutzerdefinierte Versionsnummer für die Ressourcendaten, die Tools zum Lesen und Schreiben von Ressourcendateien verwenden können. Legen Sie diesen Wert mit der optionalen VERSION-Ressourcendefinitionsanweisung fest.

Merkmale

Art: DWORD

Gibt benutzerdefinierte Informationen zur Ressource an, die Tools zum Lesen und Schreiben von Ressourcendateien verwenden können. Legen Sie diesen Wert mit der optionalen CHARACTERISTICS-Ressourcendefinitionsanweisung fest.

Bemerkungen

Ein Variablentypmember wird als Name - oder Ordinal-Member bezeichnet und wird an den meisten Stellen in der Ressourcendatei verwendet, in der ein Bezeichner angezeigt wird. Das erste WORD eines Members vom Typ Name oder Ordinal gibt an, ob es sich bei dem Element um einen numerischen Wert oder eine Zeichenfolge handelt. Wenn das erste WORD im Element dem Wert 0xffff entspricht, bei dem es sich um ein ungültiges Unicode-Zeichen handelt, ist das folgende WORD eine Typnummer. Andernfalls enthält das Element eine Unicode-Zeichenfolge, und das erste WORD im Element ist das erste Zeichen in der Namenszeichenfolge. Weitere Informationen zu Ressourcendefinitionsanweisungen finden Sie unter Ressourcendefinitionsanweisungen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]

Siehe auch

Konzept

Ressourcen

Andere Ressourcen

CHARACTERISTICS-Anweisung

LANGUAGE-Anweisung

VERSION-Anweisung