通过

Shell_GetCachedImageIndex 函数 (shlobj_core.h)

  • 项目

[Shell_GetCachedImageIndex 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Shell_GetCachedImageIndexA 或 Shell_GetCachedImageIndexW。]

检索缓存图标的缓存索引。

语法

int Shell_GetCachedImageIndex(
  [in] PCWSTR pwszIconPath,
       int    iIconIndex,
       UINT   uIconFlags
);

参数

[in] pwszIconPath

类型： PCWSTR

指向包含图像文件路径的缓冲区的指针。

iIconIndex

类型： int

名为 pwszIconPath 的文件内图像的索引。

uIconFlags

类型： UINT

未使用。

返回值

类型： int

返回图像的索引，失败时返回 –1。

注解

此函数 的Shell_GetCachedImageIndexA 和 Shell_GetCachedImageIndexW 版本已在 Windows Vista 中添加。 对于 Unicode 字符串，请调用 Shell_GetCachedImageIndexW 或 Shell_GetCachedImageIndex。 对于 ANSI 字符串，必须显式调用 Shell_GetCachedImageIndexA 。

Windows Server 2003 和 Windows XP： 仅支持 Shell_GetCachedImageIndex 。 Shell_GetCachedImageIndex 需要 Unicode 字符串。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h (包括 Shlobj.h、Shlobj_core.h、Shlobj.h、Shlobj_core.h)
Library Shell32.lib
DLL Shell32.dll (5.0 或更高版本)
API 集 Windows 10版本 10.0.10240 中引入的 ext-ms-win-shell-shell32-l1-2-1 ()

另请参阅

FileIconInit