SHMapPIDLToSystemImageListIndex 函数 (shlobj_core.h)

[SHMapPIDLToSystemImageListIndex 可用于“要求”部分中指定的操作系统。 在后续版本中,它可能已更改或不可用。]

从与文件夹项关联的系统映像列表中检索图标索引。

语法

int SHMapPIDLToSystemImageListIndex(
  [in]            IShellFolder    *pshf,
  [in]            PCUITEMID_CHILD pidl,
  [out, optional] int             *piIndexSel
);

参数

[in] pshf

类型: IShellFolder*

包含项的文件夹的 IShellFolder 接口指针。

[in] pidl

类型: PCUITEMID_CHILD

指向项的 ITEMIDLIST 结构的指针。

[out, optional] piIndexSel

类型: int*

指向 int 的指针,当此函数成功返回时,会在系统映像列表中接收项的 打开 图标的索引。 如果项没有特殊的 打开 图标,则返回其普通图标的索引。 如果 打开 的图标存在且无法获取,则 piIndex 指向的值将设置为 -1。 如果调用应用程序对打开的图标不感兴趣,此参数可以为 NULL

返回值

类型: int

如果成功,则返回系统映像列表中项的普通图标的索引,否则返回 -1。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h
Library Shell32.lib
DLL Shell32.dll (5.0 或更高版本)