Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure is used to initiate the object handler.

Syntax 

typedef struct tagReplSetup {
  UINT 
cbStruct;
  BOOL 
fRead;
  DWORD 
dwFlags;
  HRESULT 
hr;
  OBJTYPENAME 
szObjType;
  IReplNotify * 
pNotify;
  DWORD 
oid;
  DWORD 
oidNew;
  IReplStore * 
pStore;
  HREPLFLD 
hFolder;
  HREPLITEM 
hItem;
  LPBYTE 
lpbVolumeID;
  UINT 
cbVolumeID;
} REPLSETUP, * PREPLSETUP;

Members

cbStruct

Specifies the size of this structure

fRead

Specifies a Boolean value; TRUEif an object will be read and FALSEif an object will be written.

dwFlags

Specifies information about an object. See Remarksfor the possible values.

hr

[out] Specifies the result of the read/write operation.

szObjType

A null-terminated string that specifies the name of the object type.

pNotify

Reference to the IReplNotify:IUnknowninterface.

oid

Specifies an object ID.

oidNew

[out] Specifies an ID for a new object. This is different from the object ID specified by oid.

pStore

Reference to an IReplStoreinterface.

hFolder

Specifies a handle to the folder.

hItem

[in/out] Specifies a handle to the object to be read or written.

lpbVolumeID

Specifies a volume ID containing the object.

cbVolumeID

Specifies the size of lpbVolumeID, in bytes.

Remarks

The following table lists the possible values for dwFlags.

Flag Value Description

RSF_CONFLICT_OBJECT

0x00000001

Reading or writing a conflicting object.

RSF_NEW_OBJECT

0x00000002

A new object to be written.

RSF_DUPLICATED_OBJECT

0x00000004

An object is an exact duplicate of an existing object.

RSF_COMBINE

0x00000008

An object is being written to the desktop computer, and there are objects on the desktop computer to combine with the object.

RSF_SYNC_DEVICE_ONLY

0x00000010

An object should be synchronized from the device to the desktop computer only.

RSF_SYNC_DESKTOP_ONLY

0x00000020

An object should be synchronized from the desktop to the device only.

RSF_UPDATED_HANDLE

0x00000040

A new object with an ID that already exists.

RSF_DISCARDED_OBJ

0x00000080

An object is specified by the Windows Embedded CE DeleteObjectfunction, or the object is deleted because the IReplObjHandler::SetPacketmethod returned RERR_DISCARD.

RSF_NEW_VOLUME

0x00000100

An object is used only by ActiveSync service manager.

RSF_AUTO_COMBINE

0x00000200

An object is being written to the desktop computer, and there are no items on the desktop computer to combine with the object.

RSF_RESERVED1

0x00100000

Reserved by ActiveSync manager: DO NOT USE.

RSF_RESERVED2

0x00200000

Reserved by ActiveSync manager: DO NOT USE.

RSF_RESERVED3

0x00400000

Reserved by ActiveSync manager: DO NOT USE.

RSF_RESERVED4

0x00800000

Reserved by ActiveSync manager: DO NOT USE.

For Windows Mobile: The pStore, hFolder,and hItemmembers are only for applications on the desktop computer that communicate with Windows Mobile devices.

lpbVolumeIDis NULLwhen an object is stored in the default volume or RAM.

Requirements

Header cesync.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later

See Also