ILNext function (shlobj_core.h)

Retrieves the next SHITEMID structure in an ITEMIDLIST structure.

Syntax

PCUIDLIST_RELATIVE ILNext(
  [in] PCUIDLIST_RELATIVE pidl
);

Parameters

[in] 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

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	shlobj_core.h (include Shlobj.h)