UpdateResource

Функция UpdateResource добавляет, удаляет или заменяет ресурс в исполняемый файл.

(BOOL UpdateResource ОБРАБАТЫВАТЬ  hUpdate, / / обработать файл обновленияLPCTSTRlpType, / / адрес ресурса типа для обновленияLPCTSTRlpName, / / имя адрес ресурса для обновленияСловоwLanguage, / / языковой идентификатор ресурсаLPVOIDlpData, / / адрес данных ресурсовDWORDcbData / / длина данных о ресурсах, в байтах);
 

Параметры

hUpdate
Определяет дескриптор файла обновления. Этот дескриптор возвращается функцией BeginUpdateResource.
lpType
Указатель на ограниченную значением null строку, указав тип ресурса для обновления. Этот параметр также может быть целочисленное значение, переданное в MAKEINTRESOURCE макрос, или он может быть одним из следующих типов предварительно определенных ресурсов:
Значение Значение
RT_ACCELERATOR Таблица сочетаний клавиш
RT_ANICURSOR Анимированный курсор
RT_ANIICON Анимированный значок
RT_BITMAP Ресурса точечного рисунка
RT_CURSOR Ресурс аппаратно зависимую курсора
RT_DIALOG Диалоговое окно ""
RT_FONT Ресурс шрифта
RT_FONTDIR Каталог ресурса шрифтов
RT_GROUP_CURSOR Курсор аппаратно независимый ресурс
RT_GROUP_ICON Ресурс значка аппаратно независимый
RT_HTML HTML-документ
RT_ICON Ресурс значка аппаратно зависимую
RT_MENU Ресурс меню
RT_MESSAGETABLE Запись сообщений таблицы
RT_RCDATA Определяемый приложением ресурс (исходных данных)
RT_STRING Запись строк таблицы
RT_VERSION Ресурс версии

lpName
Указатель нулем строку, представляющую имя ресурса для обновления. Этот параметр также может быть целочисленное значение, переданное в MAKEINTRESOURCE макрос.
wLanguage
Указывает идентификатор языка ресурса для обновления. Список идентификаторов основного языка и диалекте идентификаторов, которые составляют идентификатор языка, MAKELANGID макрос.
lpData
Указатель на данные ресурса для вставки в исполняемый файл. Если ресурс является одним из предопределенных типов, данные должны быть действительными и должным образом согласованы. Обратите внимание, что это необработанные двоичные данные, хранящиеся в исполняемом файле, не данные, представленные LoadIcon, LoadString, или другие функции загрузки отдельных ресурсов. Все данные, содержащие строки или текст должен быть в формате Юникод; lpData не должны указывать на данных ANSI.

Если lpData имеет значение NULL, указанный ресурс будет удален из исполняемого файла.

cbData
Указывает размер в байтах данных о ресурсах в lpData.

Возвращаемые значения

Если функция выполнена успешно, возвращаемое значение не равно нулю.

Если вызов функции был неуспешен, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Примечания

Приложение может использовать UpdateResource неоднократно вносить изменения в данные ресурсов. Каждый вызов UpdateResource способствует внутреннему списку добавления, удаления и замены, но на самом деле не записывает данные в исполняемый файл. Приложение необходимо использовать функцию EndUpdateResource для записи накопившихся изменений к исполняемому файлу.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Не поддерживается.
Windows CE:Не поддерживается.
Заголовок:Объявленные в winbase.h.
Импорта библиотеки:Используйте kernel32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Обзор ресурсов, ресурсов функции, BeginUpdateResource, EndUpdateResource, LoadIcon, , LoadString, LockResource, MAKEINTRESOURCE, MAKELANGID, SizeofResource

Index