ILNext(PUIDLIST_RELATIVE) function

  • Article

Retrieves the next SHITEMID structure in an ITEMIDLIST structure.

Syntax

PUIDLIST_RELATIVE ILNext(
  _In_ PUIDLIST_RELATIVE pidl
);

Parameters

  • pidl [in]
    Type: PUIDLIST_RELATIVE

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

Return value

Type: PUIDLIST_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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

 Shlobj_core.h