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

Статья
08/26/2023

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

Синтаксис

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

Параметры

[in] pszHashItem

Тип: LPCTSTR

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

[in] iIndex

Тип: int

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

[in] uFlags

Тип: UINT

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

[in] iImageIndex

Тип: int

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

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

None

Remarks

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

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

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h, Shlobj_core.h)
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 4.7 или более поздняя)

См. также раздел

SHChangeNotify

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