Функция UpdateResource добавляет, удаляет или заменяет ресурс в исполняемом файле.
Синтаксис
BOOL UpdateResource( HANDLE hUpdate, LPCTSTR lpType, LPCTSTR lpName, WORD wLanguage, LPVOID lpData, DWORD cbData ); |
Параметры
hUpdate
[in] Устанавливает дескриптор файла модернизации. Этот дескриптор возвращается функцией BeginUpdateResource.lpType
[in] Указатель на символьную строку с нулем в конце, определяющую тип обновляемого ресурса. Этим параметром может также быть и целочисленное значение, переданное в макрос MAKEINTRESOURCE, или это может быть предопределенный тип ресурса. Список типов предопределенных ресурсов см. в статье Типы ресурсов.lpName
[in] Указатель на символьную строку с нулем в конце, определяющую имя обновляемого ресурса. Этим параметром может также быть целочисленное значение, переданное в макрос MAKEINTRESOURCE.wLanguage
[in] Устанавливает идентификатор языка модернизируемого ресурса. Список идентификаторов первичного языка и идентификаторов вариантов языка, которые составляют идентификатор языка, смотрите в макросе MAKELANGID.lpData
[in] Указатель на данные ресурса, которые будут вставлены в исполняемый файл. Если ресурс является одним из предопределенных типов, данные должны быть допустимыми и должным образом выровнены.| Обратите внимание! на то, что эти необработанные двоичные данные сохраняются в исполняемом файле, а не в данных, предоставляемых LoadIcon, LoadString или другими определяющими ресурс функциями загрузки. Все данные, содержащие символьные строки или текст, должны находиться в формате Unicode; параметр lpData не должен указывать на ANSI данные. |
Если lpData - ПУСТО (NULL), указанный ресурс удаляется из исполняемого файла.
cbData
[in] Устанавливает размер данных ресурса в lpData, в байтах.Возвращаемое значение
Если функция завершается успешно, возвращаемое значение не нуль.
Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Приложение может использовать UpdateResource неоднократно, чтобы делать изменения в данных ресурса. Каждый вызов UpdateResource вносит изменения во внутренний список дополнений, удалений и замен, но фактически не записывает данные в исполняемый файл. Приложение должно использовать функцию EndUpdateResource, чтобы записать накопленные изменения в исполняемый файл.
Пример
Пример, см. в статье Корректировка ресурсов.
Смотри такжеОбзор Ресурсы, Функции, используемые ресурсами, BeginUpdateResource , EndUpdateResource, LoadIcon, LoadString, LockResource, MAKEINTRESOURCE, MAKELANGID, SizeofResource
| Размещение и совместимость UpdateResource | |
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Нет |
|
Windows 98 |
Нет |
|
Windows 95 |
Нет |
|
Используемая библиотека |
Kernel32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winbase.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |