Функция SHUpdateImageW (shlobj_core.h)
Уведомляет оболочку об изменении образа в списке системных образов.
Синтаксис
void SHUpdateImageW(
[in] LPCWSTR 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 или более поздняя) |