Platform SDK: Synchronization Manager

ISyncMgrSynchronizeInvoke::UpdateItems

The ISyncMgrSynchronizeInvoke::UpdateItems method programmatically starts an update for the specified items.

HRESULT UpdateItems(
  DWORD dwInvokeFlags,    // Indicates how to invoke the item
  REFCLSID rclsid,        // CLSID of application that handles the update
  DWORD cbCookie,         // Size in bytes of lpCookie
  const BYTE *lpCookie    // Token of calling application
);

Parameters

dwInvokeFlags
[in] Specifies how item should be invoked using the SYNCMGRINVOKEFLAGS enumeration values.
rclsid
[in] CLSID of the registered application that should be invoked to handle the Update.
cbCookie
[in] Size in bytes of lpCookie data.
lpCookie
[in] Pointer to the private token that SyncMgr uses to identify the application. This token is passed in the ISyncMgrSynchronize::Initialize method.

Return Values

This method supports the standard return values, E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following:

S_OK
The synchronization was successfully updated.
E_FAIL
Errors occurred during the synchronization update.

Requirements

  Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with Internet Explorer 5 or later).
  Windows 95/98: Requires Windows 95 or later (with Internet Explorer 5 or later).
  Header: Declared in Mobsync.h.

See Also

ISyncMgrSynchronize::Initialize, SYNCMGRINVOKEFLAGS