IEnumIDList::Next


		Contents Index Topic Contents
	Previous Topic: IEnumIDList::Clone Next Topic: IEnumIDList::Reset

IEnumIDList::Next
HRESULT Next(
    ULONG celt,	
    LPITEMIDLIST *rgelt,	
    ULONG *pceltFetched	
   );
Retrieves the specified number of item identifiers in the enumeration sequence and advances the current position by the number of items retrieved.
Returns NOERROR if successful, S_FALSE if there are no more items in the enumeration sequence, or an OLE-defined error value otherwise.

celt
Number of elements in the array pointed to by the rgelt parameter.
rgelt
Address of an array of ITEMIDLIST pointers that receives the item identifiers. The implementation must allocate these item identifiers using the shell's allocator (retrieved by the SHGetMalloc function). The calling application is responsible for freeing the item identifiers using the shell's allocator.
pceltFetched
Address of a value that receives a count of the item identifiers actually returned in rgelt. The count can be smaller than the value specified in the celt parameter. This parameter can be NULL only if celt is one.

If this method returns any value other than NOERROR, no entries in the rgelt array are valid on exit. They are all in an indeterminate state.
See also IEnumIDList

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.