Struttura RESOURCEHEADER

Contiene informazioni sull'intestazione della risorsa stessa e sui dati specifici di questa risorsa. Questa struttura non è una vera struttura del linguaggio C, perché contiene membri a lunghezza variabile. La definizione della struttura fornita qui è solo per spiegazione; non è presente in alcun file di intestazione standard.

Sintassi

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

Members

DataSize

Tipo: DWORD

Dimensioni, in byte, dei dati che seguono l'intestazione della risorsa per questa particolare risorsa. Non include spaziatura interna file tra questa risorsa e qualsiasi risorsa che la segue nel file di risorse.

HeaderSize

Tipo: DWORD

Dimensioni, in byte, dei dati dell'intestazione della risorsa che seguono.

TYPE

Tipo: DWORD

Tipo di risorsa. Il membro TYPE può essere un valore numerico o una stringa Unicode con terminazione Null che specifica il nome del tipo. Per una descrizione dei membri di tipo Name o Ordinal , vedere la sezione Osservazioni seguente.

Se il membro TYPE è un valore numerico, può specificare un tipo di risorsa standard o definito dall'utente. Se il membro è una stringa, è un tipo di risorsa definito dall'utente. Per un elenco dei tipi di risorse predefiniti, vedere Tipi di risorse.

I valori minori di 256 sono riservati per l'uso del sistema.

NOME

Tipo: DWORD

Nome che identifica la risorsa specifica. Il membro NAME , ad esempio il membro TYPE , può essere un valore numerico o una stringa Unicode con terminazione Null. Per una descrizione dei membri di tipo Name o Ordinal , vedere la sezione Osservazioni seguente.

Non è necessario aggiungere la spaziatura interna per l'allineamento DWORD tra i membri TYPE e NAME perché contengono dati WORD . Tuttavia, potrebbe essere necessario aggiungere una parola di riempimento dopo il membro NAME per allineare il resto dell'intestazione sui limiti DWORD .

DataVersion

Tipo: DWORD

Versione predefinita dei dati delle risorse. In questo modo si determinerà quale versione dei dati della risorsa deve essere usata dall'applicazione.

MemoryFlags

Tipo: WORD

Set di flag di attributo che possono descrivere lo stato della risorsa. Modificatori in . Il file di script RC assegna questi attributi alla risorsa. Gli identificatori di script possono assegnare i valori di flag seguenti.

Le applicazioni non usano nessuno di questi attributi. Gli attributi sono consentiti nello script per la compatibilità con le versioni precedenti con gli script esistenti, ma vengono ignorati. Le risorse vengono caricate quando viene caricato il modulo corrispondente e vengono liberate quando il modulo viene scaricato.

MOVEABLE (0x0010)

FIXED (~MOVEABLE)

PURE (0x0020)

IMPURE (~PURE)

PRELOAD (0x0040)

LOADONCALL (~PRELOAD)

DISCARDABLE (0x1000)

Languageid

Tipo: WORD

Lingua per la risorsa o il set di risorse. Impostare il valore per questo membro con l'istruzione di definizione della risorsa LANGUAGE facoltativa. I parametri sono costanti del file Winnt.h.

Ogni risorsa include un identificatore di lingua in modo che il sistema o l'applicazione possa selezionare una lingua appropriata per le impostazioni locali correnti del sistema. Se sono presenti più risorse dello stesso tipo e nome che differiscono solo nella lingua delle stringhe all'interno delle risorse, sarà necessario specificare un LanguageId per ognuno di essi.

Versione

Tipo: DWORD

Numero di versione definito dall'utente per i dati delle risorse che gli strumenti possono usare per leggere e scrivere file di risorse. Impostare questo valore con l'istruzione di definizione della risorsa VERSION facoltativa.

Caratteristiche

Tipo: DWORD

Specifica le informazioni definite dall'utente sulla risorsa che gli strumenti possono usare per leggere e scrivere file di risorse. Impostare questo valore con l'istruzione facoltativa DI DEFINIZIONE della risorsa CHARACTERISTICS .

Commenti

Un membro di tipo variabile viene chiamato membro Name o Ordinale e viene usato nella maggior parte delle posizioni nel file di risorse in cui viene visualizzato un identificatore. Il primo word di un membro di tipo Name o Ordinal indica se il membro è un valore numerico o una stringa. Se il primo word nel membro è uguale al valore 0xffff, che è un carattere Unicode non valido, il seguente word è un numero di tipo. In caso contrario, il membro contiene una stringa Unicode e il primo word nel membro è il primo carattere nella stringa del nome. Per altre informazioni sulle istruzioni di definizione delle risorse, vedere Istruzioni resource-definition.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]

Vedi anche

Informazioni concettuali

Risorse

Altre risorse

Istruzione CHARACTERISTICS

Istruzione LANGUAGE

Istruzione VERSION