Функция BeginUpdateResourceA (winbase.h)

Статья
08/27/2023

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

Синтаксис

HANDLE BeginUpdateResourceA(
  [in] LPCSTR pFileName,
  [in] BOOL   bDeleteExistingResources
);

Параметры

[in] pFileName

Тип: LPCTSTR

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

[in] bDeleteExistingResources

Тип: BOOL

Указывает, следует ли удалить существующие ресурсы параметра pFileName . Если этот параметр имеет значение TRUE, существующие ресурсы удаляются, а обновленный файл включает только ресурсы, добавленные с помощью функции UpdateResource . Если этот параметр имеет значение FALSE, обновленный файл включает существующие ресурсы, если они не будут явно удалены или заменены с помощью UpdateResource.

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

Тип: HANDLE

Если функция выполняется успешно, возвращаемое значение представляет собой дескриптор, который может использоваться функциями UpdateResource и EndUpdateResource . Возвращаемое значение равно NULL , если указанный файл не является pe, файл не существует или файл не может быть открыт для записи. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Существуют некоторые ограничения на обновления ресурсов в файлах, содержащих данные конфигурации ресурсов (конфигурация RC): LN-файлы и связанные с ними MUI-файлы. Сведения о том, какие типы ресурсов можно обновлять в этих файлах, см. в разделе Примечания для функции UpdateResource .

Эта функция может обновлять ресурсы в модулях, содержащих как код, так и ресурсы. Как отмечалось выше, существуют ограничения на обновление ресурсов в LN-файлах и MUI-файлах, которые содержат данные конфигурации rc; Сведения об ограничениях приведены в справочнике по функции UpdateResource .

Примеры

Пример см. в разделе Обновление ресурсов.

Примечание

Заголовок winbase.h определяет BeginUpdateResource в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll