IEnumIDList::Next
[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.
See Also