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