Retrieves the next celt HLITEMs in the enumeration sequence.

HRESULT Next(

    ULONG 

celt,                 // Number of elements to retrieve                                         
                                                                                                          

    HLITEM * rgelt,             // Location to return at most celt                                        
                                                                                                          

    ULONG * pceltFetched        // Location to return actual number of elements returned in rgelt         
                                                                                                          

   );                                                                                                     
                                                                                                          

celt

[in] The number of elements to retrieve.

rgelt

[out] Location to return a maximum of celt HLITEM structures. This may not be NULL.

pceltFetched

[out] Location to return the actual number of elements returned in rgelt. May be NULL if the caller is not interested in the actual number of elements returned.

Return Values

S_OK

Indicates all of the elements specified by celt have been successfully supplied.

S_FALSE

Indicates fewer than the number of elements specified by celt have been successfully supplied. The number actually supplied (including zero) is in rgelt and their values reached through pceltFetched, if non-NULL.

See Also

TBD