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

Статья
08/27/2023

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

Синтаксис

HANDLE BeginUpdateResourceW(
  [in] LPCWSTR pFileName,
  [in] BOOL    bDeleteExistingResources
);

Параметры

[in] pFileName

Тип: LPCTSTR

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

[in] bDeleteExistingResources

Тип: BOOL

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

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

Тип: HANDLE

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

Существуют некоторые ограничения на обновления ресурсов в файлах, содержащих данные конфигурации ресурсов (конфигурация-кандидат): 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