IReplStore::FindFirstItem

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

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

Parameters

• hFolder
  [in] Handler to a folder.

• phItem
  [out] Pointer to a handle to the first 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 function.

Remarks

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

It is possible that, before FindItemClose is called, a different thread calls methods like DeleteObject that write to the store. Therefore, it is important for the ActiveSync service provider to have thread synchronization between this method and the methods that write to the store. A typical ActiveSync service provider would use critical section to make sure that, during the time between calls to FindFirstItem and FindItemClose, no write to the store is permitted.

Requirements

See Also

Reference

IReplStore::FindItemClose
IReplStore::FindNextItem
HREPLITEM

Other Resources

DeleteObject