функция Shell_GetCachedImageIndexW (shlobj_core.h)

Статья
11/20/2024

[Shell_GetCachedImageIndex доступен для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. Вместо этого используйте Shell_GetCachedImageIndexA или Shell_GetCachedImageIndexW.]

Извлекает индекс кэша значка кэша.

Синтаксис

int Shell_GetCachedImageIndexW(
  LPCWSTR pszIconPath,
  int     iIconIndex,
  UINT    uIconFlags
);

Параметры

pszIconPath

ТБD

iIconIndex

Тип: int

Индекс изображения в файле с именем pwszIconPath.

uIconFlags

Тип: UINT

Не используется.

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

Тип: int

Возвращает индекс изображения или –1 при сбое.

Замечания

В Windows Vista добавлены Shell_GetCachedImageIndexA и Shell_GetCachedImageIndexW версии этой функции. Для строк Юникода вызовите Shell_GetCachedImageIndexW или Shell_GetCachedImageIndex. Для строк ANSI необходимо явно вызывать Shell_GetCachedImageIndexA.

Windows Server 2003 и Windows XP: поддерживается только Shell_GetCachedImageIndex. Shell_GetCachedImageIndex требуется строка Юникода.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	shlobj_core.h (include Shlobj.h, Shlobj_core.h, Shlobj.h, Shlobj_core.h)
библиотеки	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя версия)
набор API	ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240)

См. также

FileIconInit

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