Share via


IPOutlookItemCollection::FindNext

Send Feedback

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.

Return Values

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.

Parenthesizeing 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

Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: pimstore.h
Library: pimstore.lib

See Also

How to: Find a Particular PIM Item within a Collection | IPOutlookItemCollection::Find | IPOutlookItemCollection | Pocket Outlook Object Model API Interfaces

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.