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

Статья
11/20/2024

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

Синтаксис

BOOL EndUpdateResourceA(
  [in] HANDLE hUpdate,
  [in] BOOL   fDiscard
);

Параметры

[in] hUpdate

Тип: HANDLE

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

[in] fDiscard

Тип: BOOL

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

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

Тип: BOOL

Возвращает TRUE, если функция выполнена успешно; FALSE в противном случае. Если функция завершается успешно и fDiscardTRUE, то в файл не выполняются обновления ресурсов; в противном случае все успешные обновления ресурсов вносятся в файл. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Перед вызовом этой функции убедитесь, что все дескрипторы файлов, отличные от возвращенного BeginUpdateResource, закрыты.

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

Примеры

Пример см. в обновлении ресурсов.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll