Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IPOutlookItemCollection::FindNext

Windows Mobile 6.5
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.


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.

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.

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" )
Headerpimstore.h
LibraryPimstore.lib
Windows Embedded CEWindows CE 2.0 and later
Windows MobileWindows Mobile Version 5.0 and later
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.