Export (0) Print
Expand All
Expand Minimize

ILNext(PUIDLIST_RELATIVE) function

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.h

 

 

Community Additions

ADD
Show:
© 2014 Microsoft