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 或更高版本) |