STRUCTURE RESOURCEHEADER
Contient des informations sur l’en-tête de ressource lui-même et les données spécifiques à cette ressource. Cette structure n’est pas une véritable structure en langage C, car elle contient des membres de longueur variable. La définition de structure fournie ici est fournie à des fins d’explication uniquement ; il n’est présent dans aucun fichier d’en-tête standard.
Syntaxe
typedef struct {
DWORD DataSize;
DWORD HeaderSize;
DWORD TYPE;
DWORD NAME;
DWORD DataVersion;
WORD MemoryFlags;
WORD LanguageId;
DWORD Version;
DWORD Characteristics;
} RESOURCEHEADER;
Membres
-
DataSize
-
Type : DWORD
-
Taille, en octets, des données qui suivent l’en-tête de ressource pour cette ressource particulière. Il n’inclut aucun remplissage de fichier entre cette ressource et une ressource qui la suit dans le fichier de ressources.
-
HeaderSize
-
Type : DWORD
-
Taille, en octets, des données d’en-tête de ressource qui suivent.
-
TYPE
-
Type : DWORD
-
Type de ressource. Le membre TYPE peut être une valeur numérique ou une chaîne Unicode terminée par une valeur Null qui spécifie le nom du type. Consultez la section Remarques suivante pour obtenir une description des membres de type Nom ou Ordinal .
Si le membre TYPE est une valeur numérique, il peut spécifier un type de ressource standard ou défini par l’utilisateur. Si le membre est une chaîne, il s’agit d’un type de ressource défini par l’utilisateur. Pour obtenir la liste des types de ressources prédéfinis, consultez Types de ressources.
Les valeurs inférieures à 256 sont réservées à l’utilisation du système.
-
NAME
-
Type : DWORD
-
Nom qui identifie la ressource particulière. Le membre NAME , comme le membre TYPE , peut être une valeur numérique ou une chaîne Unicode terminée par null. Consultez la section Remarques suivante pour obtenir une description des membres de type Nom ou Ordinal .
Vous n’avez pas besoin d’ajouter de remplissage pour l’alignement DWORD entre les membres TYPE et NAME , car ils contiennent des données WORD . Toutefois, vous devrez peut-être ajouter un MOT de remplissage après le membre NAME pour aligner le reste de l’en-tête sur les limites DWORD .
-
DataVersion
-
Type : DWORD
-
Version de données de ressource prédéfinie. Cette opération détermine la version des données de ressource que l’application doit utiliser.
-
MemoryFlags
-
Type : WORD
-
Ensemble d’indicateurs d’attribut qui peuvent décrire l’état de la ressource. Modificateurs dans . Le fichier de script RC attribue ces attributs à la ressource. Les identificateurs de script peuvent affecter les valeurs d’indicateur suivantes.
Les applications n’utilisent aucun de ces attributs. Les attributs sont autorisés dans le script à des fins de compatibilité descendante avec les scripts existants, mais ils sont ignorés. Les ressources sont chargées lorsque le module correspondant est chargé, et sont libérées lorsque le module est déchargé.
-
MOVEABLE (0x0010)
-
RÉSOLU (~MOVEABLE)
-
PURE (0x0020)
-
IMPURE (~PURE)
-
PRELOAD (0x0040)
-
LOADONCALL (~PRELOAD)
-
DISCARDABLE (0x1000)
LanguageId
Type : WORD
Langue de la ressource ou de l’ensemble de ressources. Définissez la valeur de ce membre avec l’instruction facultative de définition de ressource LANGUAGE . Les paramètres sont des constantes du fichier Winnt.h.
Chaque ressource inclut un identificateur de langue afin que le système ou l’application puisse sélectionner une langue appropriée pour les paramètres régionaux actuels du système. S’il existe plusieurs ressources du même type et du même nom qui diffèrent uniquement par la langue des chaînes au sein des ressources, vous devez spécifier un LanguageId pour chacune d’elles.
Version
Type : DWORD
Numéro de version défini par l’utilisateur pour les données de ressources que les outils peuvent utiliser pour lire et écrire des fichiers de ressources. Définissez cette valeur avec l’instruction de définition de ressource VERSION facultative.
Caractéristiques
Type : DWORD
Spécifie des informations définies par l’utilisateur sur la ressource que les outils peuvent utiliser pour lire et écrire des fichiers de ressources. Définissez cette valeur avec l’instruction facultative de définition de ressource CHARACTERISTICS .
Notes
Un membre de type variable est appelé membre Name ou Ordinal , et il est utilisé à la plupart des endroits dans le fichier de ressources où un identificateur apparaît. Le premier MOT d’un membre de type Name ou Ordinal indique si le membre est une valeur numérique ou une chaîne. Si le premier MOT du membre est égal à la valeur 0xffff, qui est un caractère Unicode non valide, le MOT suivant est un numéro de type. Sinon, le membre contient une chaîne Unicode et le premier mot du membre est le premier caractère de la chaîne de nom. Pour plus d’informations sur les instructions de définition de ressource, consultez Instructions resource-Definition.
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
Voir aussi
-
Conceptuel
-
Autres ressources