[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