Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

SHMapPIDLToSystemImageListIndex function

[SHMapPIDLToSystemImageListIndex is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Retrieves the icon index from the system image list that is associated with a folder item.


int SHMapPIDLToSystemImageListIndex(
  _In_      IShellFolder    *psf,
  _In_      PCUITEMID_CHILD pidl,
  _Out_opt_ int             *piIndex


psf [in]

Type: IShellFolder*

An IShellFolder interface pointer for the folder that contains the item.

pidl [in]


A pointer to the item's ITEMIDLIST structure.

piIndex [out, optional]

Type: int*

A pointer to an int that, when this function returns successfully, receives the index of the item's open icon in the system image list. If the item does not have a special open icon then the index of its normal icon is returned. If the open icon exists and cannot be obtained, then the value pointed to by piIndex is set to -1. This parameter can be NULL if the calling application is not interested in the open icon.

Return value

Type: int

Returns the index of the item's normal icon in the system image list if successful, or -1 otherwise.


Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP with SP2

End of server support

Windows Server 2003






Shell32.dll (version 5.0 or later)



Community Additions

© 2015 Microsoft