IReplStore::GetFolderInfo

The IReplStore::GetFolderInfo method creates a new HREPLFLD of a folder for the given object type name and returns a pointer to the IReplObjHandler interface that's used to serialize and deserialize all items in this folder.

Syntax

HRESULT GetFolderInfo(
LPSTR lpszName,
HREPLFLD * phFolder,
IUnknown **ppObjHandler
);

At a Glance

Header file: Cesync.h
Platforms: H/PC
Windows CE versions: 2.0 and later

Parameters

lpszName
Name of the object type as taken from the registry.
phFolder
Output pointer. Points to the handle of the folder.
ppObjHandler
Output pointer. Points to a pointer to the IReplObjHandler interface.

Return Values

NOERROR
The operation was successful.

Remarks

The IReplStore::GetFolderInfo method is the only method in IReplStore that creates or modifies a HREPLFLD structure for the folder. The ActiveSync service manager calls this method to get a folder handle for the given object type. Object types are configured into the registry, where object type name and other relevant information about an object type are stored. Note that the handle pointed to by phFolder may or may not be NULL when called. If phFolder points to a handle that has a NULL value, the ActiveSync service provider should create a new handle for the given folder. If phFolder points to a pointer that has a value, the ActiveSync service provider should modify the data indicated by this handle.

See Also

IReplStore