Функция BeginUpdateResource

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

Синтаксис

HANDLE BeginUpdateResource(      
    LPCTSTR pFileName,
    BOOL bDeleteExistingResources
);

Параметры

pFileName

[in] Указатель на символьную строку с нулем в конце, определяющую исполняемый файл, в котором модернизируются ресурсы. Приложение должно быть в состоянии получить доступ для записи в этом файле; в настоящее время это не может быть выполнено. Если pFileName не определяет полный путь, система ищет файл в текущем каталоге.

bDeleteExistingResources

[in] Устанавливает, удалять ли существующие ресурсы, определенные параметром pFileName. Если этот параметр - ИСТИНА (TRUE), существующие ресурсы удаляются, а обновленный исполняемый файл включает только ресурсы, добавляемые функцией UpdateResource. Если этот параметр - ЛОЖЬ (FALSE), обновленный исполняемый файл включает существующие ресурсы, если они явно не удалены или заменены, при помощи использования UpdateResource.

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

Если функция завершается успешно, возвращаемое значение - дескриптор, который может использоваться функциями UpdateResource и EndUpdateResource. Возвращаемое значение - ПУСТО (NULL), если указанный файл - не исполняемый файл, исполняемый файл уже загружен, файл не существует или файл не может открыться для записи. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Пример

Пример смотри в статье Корректировка ресурсов.

Смотри также

Обзор Ресурсы, Функции, используемые ресурсами, EndUpdateResource, UpdateResource

Размещение и совместимость BeginUpdateResource
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Используемая библиотека	Kernel32.lib
Заголовочный файл
- объявлено в	Winbase.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется