IPOutlookItemCollection::FindNext
The FindNext method finds the next POOM item in a collection that passes the restriction specified by the most recent call to IPOutlookItemCollection::Find.
HRESULT FindNext( IDispatch ** ppolItem );
- ppolItem
-
[out] A reference to the item found. It is set to NULL if no item passes the restriction. For information about IDispatch, see IDispatch.
You can call this function only after calling IPOutlookItemCollection::Find. Using Find and FindNext, you can enumerate all the items in a collection that meet a particular restriction.
Do not to call FindNext after reaching the end of a collection.
Items are returned in the sequence determined by the current sort order.
Parenthesizing a restrict query has the effect of causing the query to be evaluated from right-to-left, as opposed to left-to-right. For example, the two queries below yield different results. The only difference is the usage of parenthesis.
Query 1: [Categories] = "Health" AND [SourceId] = 16 OR [Subject] = "Water" Query 2: ( ( [Categories] = "Health" AND [SourceId] = 16) OR [Subject] = "Water" )
