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 |
|
Send comments about this topic to Microsoft
Build date: 11/28/2012
