IEnumIDList::Next

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
-
Header File
shlobj.h
Unicode
No
Platform Notes
None

[Now Supported on Windows NT]

Retrieves the specified number of item identifiers in the enumeration sequence and advances the current position.

HRESULT Next(

IEnumIDList FAR *pEnumIDList,
ULONG celt,
LPITEMIDLIST *rgelt,
ULONG *pceltFetched
);

Returns the NOERROR value if successful, the S_FALSE value if there are no more items in the enumeration sequence, or an OLE-defined error value if an error occurs.

Parameters
pEnumIDList
Address of the IEnumIDList interface. In C++, this parameter is implicit.

celt
Specifies the number of elements in the array pointed to by the rgelt parameter.

rgelt
Address of an array in which to return the item identifiers. The calling application must free the item identifiers by using the task allocator (retrieved by the SHGetMalloc function).

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 if, and only if, celt is one.

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