IReplStore::GetFolderInfo

The GetFolderInfo method creates or modifies a handle to a folder for a specified object type. The handle is a Windows CE HREPLFLD structure. The method also returns a reference to a IReplObjHandler interface object that is used to serialize or deserialize all items in this folder.

Syntax

HRESULT GetFolderInfo (
  LPSTR lpszObjType,
  HREPLFLD * phFld,
  IUnknown ** pUnk
);

Parameters

lpszObjType
[in] Reference to a null-terminated string that specifies the name of the object type.
phFld
[out] Reference to a handle to the folder.
pUnk
[out] Reference to a IReplObjHandler interface object.

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

The ActiveSync service manager calls this method.

If phFld references a handle that has a NULL value, an ActiveSync service provider should create a new handle for the specified folder. If phFld references a handle that has a value, the service provider should modify the contents of the handle.

Object types are configured in the registry, where object type name and other information are stored.

Requirements

Pocket PC: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: cesync.h
Library: None