ILNext function

Retrieves the next SHITEMID structure in an ITEMIDLIST structure.

Syntax

PCUIDLIST_RELATIVE ILNext(
  PCUIDLIST_RELATIVE pidl
);

Parameters

pidl

Type: PCUIDLIST_RELATIVE

A constant, unaligned, relative PIDL for which the next SHITEMID structure is being retrieved.

Return Value

Type: PCUIDLIST_RELATIVE

When this function returns, contains one of three results: If pidl is valid and not the last SHITEMID in the ITEMIDLIST, then it contains a pointer to the next ITEMIDLIST structure. If the last ITEMIDLIST structure is passed, it contains NULL, which signals the end of the PIDL. For other values of pidl, the return value is meaningless.

Remarks

For use where STRICT_TYPED_ITEMIDS is defined.

To verify if the return value is NULL, use ILIsEmpty.

Requirements

   
Windows version Windows Vista [desktop apps only] Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shlobj_core.h (include Shlobj.h)