На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

UpdateResource



The UpdateResource function adds, deletes, or replaces a resource in an executable file.

BOOL UpdateResource(

HANDLE hUpdate, // update-file handle
LPCTSTR lpType, // address of resource type to update
LPCTSTR lpName, // address of resource name to update
WORD wLanguage, // language identifier of resource
LPVOID lpData, // address of resource data
DWORD cbData // length of resource data, in bytes
);


Parameters

hUpdate

Specifies an update-file handle. This handle is returned by the BeginUpdateResource function.

lpType

Points to a null-terminated string specifying the resource type to be updated. This parameter can also be an integer value passed to the MAKEINTRESOURCE macro, or it can be one of the following predefined resource types:

Value Meaning
RT_ACCELERATOR Accelerator table
RT_ANICURSOR Animated cursor
RT_ANIICON Animated icon
RT_BITMAP Bitmap resource
RT_CURSOR Hardware-dependent cursor resource
RT_DIALOG Dialog box
RT_FONT Font resource
RT_FONTDIR Font directory resource
RT_GROUP_CURSOR Hardware-independent cursor resource
RT_GROUP_ICON Hardware-independent icon resource
RT_ICON Hardware-dependent icon resource
RT_MENU Menu resource
RT_MESSAGETABLE Message-table entry
RT_RCDATA Application-defined resource (raw data)
RT_STRING String-table entry
RT_VERSION Version resource


lpName

Points to a null-terminated string specifying the name of the resource to be updated. This parameter can also be an integer value passed to the MAKEINTRESOURCE macro.

wLanguage

Specifies the language identifier of the resource to be updated. For a list of the primary language identifiers and sublanguage identifiers that make up a language identifier, see the MAKELANGID macro

lpData

Points to the resource data to be inserted into the executable file. If the resource is one of the predefined types, the data must be valid and properly aligned. Note that this is the raw binary data stored in the executable file, not the data provided by LoadIcon, LoadString, or other resource-specific load functions. All data containing strings or text must be in Unicode format; lpData must not point to ANSI data.
If lpData is NULL, the specified resource is deleted from the executable file.

cbData

Specifies the size, in bytes, of the resource data at lpData.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

An application can use UpdateResource repeatedly to make changes to the resource data. Each call to UpdateResource contributes to an internal list of additions, deletions, and replacements but does not actually write the data to the executable file. The application must use the EndUpdateResource function to write the accumulated changes to the executable file.

See Also

BeginUpdateResource, EndUpdateResource, LoadIcon, LoadString, LockResource, MAKEINTRESOURCE, MAKELANGID, SizeofResource


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

UpdateResource



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

BOOL UpdateResource(

РУЧКА hUpdate, // коррекция-файл оперируют LPCTSTR lpType, // адрес типа ресурса, чтобы корректировать LPCTSTR lpName, // адрес имени ресурса, чтобы корректировать ТЕКСТОВЫЙ wLanguage, // языковой идентификатор ресурса LPVOID lpData, // адреса данных ресурса DWORD cbData // длина данных ресурса, в байтах
);


Параметры

hUpdate

Определяет корректировать-файловую ручку. Эта ручка возвращана функцией BeginUpdateResource.

lpType

Точки на недействительный расторгнутую строку, определяющие тип ресурса, чтобы быть скорректированн. Этот параметр может также быть величиной целого пройденной в макро MAKEINTRESOURCE, или это может быть одним из следующих встроенных типов ресурса:

Значение Величины
таблица Акселератора RT_ACCELERATOR Оживленного курсора RT_ANICURSOR RT_ANIICON Оживленного иконного ресурса Аппаратно-зависимого курсора ресурса Побитового отображения RT_BITMAP блока Диалога RT_CURSOR ресурса директория Шрифта ресурса Шрифта RT_DIALOG RT_FONT Аппаратно-независимого ресурса курсора RT_FONTDIR RT_GROUP_CURSOR Аппаратно-независимого иконного ресурса RT_GROUP_ICON Аппаратно-зависимого иконного Меню ресурса RT_ICON ресурса RT_MENU RT_MESSAGETABLE Сообщений-табличный вход RT_RCDATA определяла ресурс Приложения (исходных данных) RT_STRING Нанизывать-табличный ресурс Версии входа RT_VERSION


lpName

Точки на недействительный расторгнутую строку, определяющие имя ресурса, который нужно корректироваться. Этот параметр может также быть величиной целого пройденной в макро MAKEINTRESOURCE.

wLanguage

Определяет языковой идентификатор ресурса, который нужно корректироваться. Для списка первичных языковых идентификаторов и идентификаторов подъязыка, которые создают языковой идентификатор, смотри макро MAKELANGID

lpData

Точки на данные ресурса, которые нужно включаться в выполняемый файл. Если ресурс - один из встроенных типов, данные должны быть в силе и правильно выровненное. Отметьте, что это - сырие двоичные данные загруженные в выполняемый файл, не данные предусматривались LoadIcon, LoadString, или другими ресурс-специфическими функциями загрузки. Все данные, содержащие строки или текст должен быть в формате Уникода; lpData Не должен указывать на данные ANSI.
Если lpData НЕДЕЙСТВИТЕЛЕН, определенный ресурс удален из выполняемого файла.

cbData

Определяет размер, в байтах, данных ресурса в lpData.



Обратные Величины

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

Замечания

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

Смотри Также

BeginUpdateResource, EndUpdateResource, LoadIcon, LoadString, LockResource, MAKEINTRESOURCE, MAKELANGID, SizeofResource


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz