Estrutura RESOURCEHEADER

Contém informações sobre o cabeçalho do recurso em si e os dados específicos desse recurso. Essa estrutura não é uma estrutura de linguagem C verdadeira, pois contém membros de comprimento variável. A definição de estrutura fornecida aqui é apenas para explicação; ele não está presente em nenhum arquivo de cabeçalho padrão.

Sintaxe

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

Membros

DataSize

Tipo: DWORD

O tamanho, em bytes, dos dados que seguem o cabeçalho do recurso para esse recurso específico. Ele não inclui nenhum preenchimento de arquivo entre esse recurso e qualquer recurso que o siga no arquivo de recurso.

HeaderSize

Tipo: DWORD

O tamanho, em bytes, dos dados de cabeçalho do recurso a seguir.

TYPE

Tipo: DWORD

O tipo de recurso. O membro TYPE pode ser um valor numérico ou uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do tipo. Consulte a seção Comentários a seguir para obter uma descrição dos membros do tipo Name ou Ordinal .

Se o membro TYPE for um valor numérico, ele poderá especificar um tipo de recurso padrão ou definido pelo usuário. Se o membro for uma cadeia de caracteres, ele será um tipo de recurso definido pelo usuário. Para obter uma lista dos tipos de recursos predefinidos, consulte Tipos de recursos.

Valores menores que 256 são reservados para uso do sistema.

NOME

Tipo: DWORD

Um nome que identifica o recurso específico. O membro NAME , como o membro TYPE , pode ser um valor numérico ou uma cadeia de caracteres Unicode terminada em nulo. Consulte a seção Comentários a seguir para obter uma descrição dos membros do tipo Name ou Ordinal .

Você não precisa adicionar preenchimento para alinhamento DWORD entre os membros TYPE e NAME porque eles contêm dados do WORD . No entanto, talvez seja necessário adicionar um WORD de preenchimento após o membro NAME para alinhar o restante do cabeçalho nos limites do DWORD .

DataVersion

Tipo: DWORD

Uma versão de dados de recurso predefinida. Isso determinará qual versão dos dados de recurso o aplicativo deve usar.

MemoryFlags

Tipo: WORD

Um conjunto de sinalizadores de atributo que pode descrever o estado do recurso. Modificadores no . O arquivo de script RC atribui esses atributos ao recurso. Os identificadores de script podem atribuir os seguintes valores de sinalizador.

Os aplicativos não usam nenhum desses atributos. Os atributos são permitidos no script para compatibilidade com versões anteriores com scripts existentes, mas são ignorados. Os recursos são carregados quando o módulo correspondente é carregado e liberados quando o módulo é descarregado.

MOVEABLE (0x0010)

CORRIGIDO (~MOVEABLE)

PURE (0x0020)

IMPURE (~PURE)

PRELOAD (0x0040)

LOADONCALL (~PRELOAD)

DISCARDABLE (0x1000)

Languageid

Tipo: WORD

O idioma para o recurso ou conjunto de recursos. Defina o valor para esse membro com a instrução de definição de recurso LANGUAGE opcional. Os parâmetros são constantes do arquivo Winnt.h.

Cada recurso inclui um identificador de idioma para que o sistema ou aplicativo possa selecionar um idioma apropriado para a localidade atual do sistema. Se houver vários recursos do mesmo tipo e nome que diferem apenas no idioma das cadeias de caracteres dentro dos recursos, você precisará especificar um LanguageId para cada um deles.

Versão

Tipo: DWORD

Um número de versão definido pelo usuário para os dados de recurso que as ferramentas podem usar para ler e gravar arquivos de recursos. Defina esse valor com a instrução de definição de recurso VERSION opcional.

Características

Tipo: DWORD

Especifica informações definidas pelo usuário sobre o recurso que as ferramentas podem usar para ler e gravar arquivos de recursos. Defina esse valor com a instrução de definição de recurso CHARACTERISTICS opcional.

Comentários

Um membro de tipo de variável é chamado de nome ou membro Ordinal e é usado na maioria dos locais no arquivo de recurso em que um identificador aparece. O primeiro WORD de um nome ou membro de tipo ordinal indica se o membro é um valor numérico ou uma cadeia de caracteres. Se o primeiro WORD no membro for igual ao valor 0xffff, que é um caractere Unicode inválido, o WORD a seguir será um número de tipo. Caso contrário, o membro contém uma cadeia de caracteres Unicode e o primeiro WORD no membro é o primeiro caractere na cadeia de caracteres de nome. Para obter informações adicionais sobre instruções de definição de recurso, consulte Instruções resource-definition.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]

Confira também

Conceitual

Recursos

Outros recursos

Instrução CHARACTERISTICS

Instrução LANGUAGE

Instrução VERSION