Share via

REPLSETUP

  • Article

The REPLSETUP structure is used to initiate an 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; TRUE if an object will be read and FALSE if an object will be written.
  • dwFlags
    Specifies information about an object. See Remarks for 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 Windows CE IReplNotify:IUnknown interface.
  • 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 IReplStore interface.
  • 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 CE DeleteObject function, or the object is deleted because the IReplObjHandler::SetPacket method 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.

The pStore, hFolder, and hItem members are only for applications on the desktop computer that communicate with Windows Mobile-based devices.

lpbVolumeID is NULL when an object is stored in the default volume or RAM.

Requirements

Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: cesync.h

See Also

ActiveSync API Structures

DeleteObject

IReplNotify:IUnknown

IReplObjHandler::SetPacket

IReplObjHandler::Setup

IReplStore

Last updated on Friday, April 22, 2005

© 2005 Microsoft Corporation. All rights reserved.

Send feedback on this topic to the authors.