Share via

IReplStore::FindNextItem

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method returns a new item handle to the next object in a specified folder, if there is any.

Syntax

HRESULT FindNextItem(
  HREPLFLD hFolder,
  HREPLITEM* phItem,
  BOOL* pfExist
);

Parameters

  • hFolder
    [in] Handle to a folder.
  • phItem
    [out] Pointer to a handle to the next object in the folder.
  • pfExist
    [out] Pointer to a Boolean value that is set TRUE if there is an object in the folder.

Return Value

The following table describes the return values for this method.

Value Description

E_FAIL

There are problems with the enumeration. Replication should ignore the folder.

NOERROR

A new HREPLITEM was created for the next object in the folder and its pointer has been returned.

Remarks

FindNextItem works with FindFirstItem and FindItemClose to enumerate all items in a specified folder. FindNextItem and FindFirstItem are the only methods in IReplStore that can create HREPLITEM structures for the objects. All HREPLITEM structures passed by the ActiveSync manager are guaranteed to be originally created from these two methods.

Requirements

Header cesync.h
Library coredll.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

HREPLITEM
IReplStore
IReplStore::FindFirstItem
IReplStore::FindItemClose