Поделиться через

Структура RESOURCEHEADER

  • Статья

Содержит сведения о самом заголовке ресурса и данных, относящихся к этому ресурсу. Эта структура не является истинной структурой языка 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 может быть числовым значением или строкой Юникода с пустым завершением, указывающей имя типа. Описание элементов типа Name или Ordinal см. в следующем разделе Примечания.

Если элемент TYPE является числовым значением, он может указать стандартный или определяемый пользователем тип ресурса. Если элемент является строкой, то это определяемый пользователем тип ресурса. Список стандартных типов ресурсов см. в разделе Типы ресурсов.

Значения меньше 256 зарезервированы для использования системой.

ИМЯ

Тип: DWORD

Имя, определяющее конкретный ресурс. Элемент NAME , как и элемент TYPE , может быть числовым значением или строкой Юникода, заканчивающейся null. Описание элементов типа Name или Ordinal см. в следующем разделе Примечания.

Вам не нужно добавлять заполнение для выравнивания DWORD между элементами TYPE и NAME , так как они содержат данные WORD . Однако может потребоваться добавить word с заполнением после элемента NAME , чтобы выровнять остальную часть заголовка по границам DWORD .

DataVersion

Тип: DWORD

Предопределенная версия данных ресурса. Это определяет, какую версию данных ресурса должно использовать приложение.

MemoryFlags

Тип: WORD

Набор флагов атрибутов, которые могут описывать состояние ресурса. Модификаторы в . Файл скрипта RC назначает эти атрибуты ресурсу. Идентификаторы скриптов могут назначать следующие значения флагов.

Приложения не используют ни один из этих атрибутов. Атрибуты разрешены в скрипте для обеспечения обратной совместимости с существующими скриптами, но они игнорируются. Ресурсы загружаются при загрузке соответствующего модуля и освобождаются при выгрузке модуля.

MOVEABLE (0x0010)

ИСПРАВЛЕНО (~MOVEABLE)

PURE (0x0020)

IMPURE (~PURE)

ПРЕДВАРИТЕЛЬНАЯ ЗАГРУЗКА (0x0040)

LOADONCALL (~PRELOAD)

ОТМЕНА (0x1000)

LanguageId

Тип: WORD

Язык ресурса или набора ресурсов. Задайте значение для этого элемента с помощью необязательной инструкции определения ресурса LANGUAGE . Параметры являются константами из файла Winnt.h.

Каждый ресурс содержит идентификатор языка, чтобы система или приложение могли выбрать язык, соответствующий текущему языковому стандарту системы. Если существует несколько ресурсов одного типа и имени, которые отличаются только языком строк в ресурсах, необходимо указать LanguageId для каждого из них.

Версия

Тип: DWORD

Определяемый пользователем номер версии для данных ресурсов, которые инструменты могут использовать для чтения и записи файлов ресурсов. Задайте это значение с помощью необязательной инструкции определения ресурса VERSION .

Характеристики

Тип: DWORD

Указывает определяемые пользователем сведения о ресурсе, который инструменты могут использовать для чтения и записи файлов ресурсов. Задайте это значение с помощью необязательной инструкции определения ресурса CHARACTERISTICS .

Комментарии

Элемент типа переменной называется элементом Name или Ordinal и используется в большинстве мест в файле ресурсов, где отображается идентификатор. Первый word элемента типа Name или Ordinal указывает, является ли элемент числовым значением или строкой. Если первое слово WORD в элементе равно значению 0xffff, которое является недопустимым символом Юникода, то следующее слово WORD является числом типа. В противном случае элемент содержит строку Юникода, а первое слово WORD в элементе является первым символом в строке имени. Дополнительные сведения об инструкциях определения ресурсов см. в разделе Операторы определения ресурсов.

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]

См. также раздел

Основные понятия

Ресурсы

Другие ресурсы

Оператор CHARACTERISTICS

Оператор LANGUAGE

Инструкция VERSION