ILNext(PCUIDLIST_RELATIVE) function

Retrieves the next SHITEMID structure in an ITEMIDLIST structure.

Syntax


PCUIDLIST_RELATIVE ILNext(
  _In_ PCUIDLIST_RELATIVE pidl
);

Parameters

pidl [in]

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shlobj.h

 

 

Show: