Функция SHUpdateImageA (shlobj_core.h)

Статья
11/20/2024

Уведомляет оболочку о том, что изображение в списке системных образов изменилось.

Синтаксис

void SHUpdateImageA(
  [in] LPCSTR pszHashItem,
  [in] int    iIndex,
  [in] UINT   uFlags,
  [in] int    iImageIndex
);

Параметры

[in] pszHashItem

Тип: LPCTSTR

Указатель на строковое значение, указывающее полный путь к файлу, который содержит значок. Используйте путь, возвращаемый в буфере, на который указывает параметр szIconFileIExtractIcon::GetIconLocation.

[in] iIndex

Тип: int

Целое число, указывающее отсчитываемый от нуля индекс значка в файле, указанном pszHashItem. Используйте значение, указываемое параметром piIndexIExtractIcon::GetIconLocation.

[in] uFlags

Тип: UINT

Целое число без знака, указывающее флаги, определяющие атрибуты значка. Задайте uFlags значением, на которое указывает параметр pwFlagsIExtractIcon::GetIconLocation. Флаги, относящиеся к SHUpdateImage, являются GIL_NOTFILENAME и GIL_SIMULATEDOC.

[in] iImageIndex

Тип: int

Целое число, указывающее индекс в списке системных образов обновляемого значка.

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

Никакой

Замечания

Если вы не знаете индекс в списке системных образов значка, который требуется обновить, используйте SHGetFileInfo с параметром uFlags значение SHGFI_SYSICONINDEX.

Необходимо использовать IExtractIcon::GetIconLocation с параметрами старого значка, который необходимо обновить, а не с новым значком, на который вы хотите заменить его.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	shlobj_core.h (include Shlobj.h, Shlobj_core.h)
библиотеки	Shell32.lib
DLL	Shell32.dll (версия 4.7 или более поздняя)

См. также

SHChangeNotify

Поделиться через