IPOutlookItemCollection::FindNext
A version of this page is also available for
4/8/2010
The FindNext method finds the next POOM item in a collection that passes the restriction specified by the most recent call to IPOutlookItemCollection::Find.
Syntax
HRESULT FindNext(
IDispatch ** ppolItem
);
Parameters
- 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.
Return Value
This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:
- S_OK
The method completed successfully.
Remarks
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" )
Requirements
| Header | pimstore.h |
| Library | Pimstore.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Tasks
Finding a PIM Item Within a Collection
Reference
IPOutlookItemCollection::Find
IPOutlookItemCollection
Pocket Outlook Object Model Interfaces