ISyncMgrSynchronizeCallback::ShowErrorCompleted

The registered application's handler must call the ISyncMgrSynchronizeCallback::ShowErrorCompleted method before or after its ISyncMgrSynchronize::PrepareForSync operation has been completed

HRESULT ShowErrorCompleted(
  [in] HRESULT hrResult,
  [in] ULONG cbNumItems,
  [in] SYNCMGRITEMID *pItemIDs
);

Parameters

hrResult

[in] indicates whether ISyncMgrSynchronize::ShowError was successful. This value is S_SYNCMGR_RETRYSYNC if the registered application's handler requires SyncMgr to retry the Synchronization. When this value is returned to SyncMgr both the ISyncMgrSynchronize::PrepareForSync and ISyncMgrSynchronize::Synchronize methods are called again.

cbNumItems

[in] Indicates the number of ItemIds in the pItemIDs parameter. This parameter is ignored unless hrResult is S_SYNCMGR_RETRYSYNC.

pItemIDs

[in] pointer to array of ItemIds to pass to ISyncMgrSynchronize::PrepareForSync in the event of a retry. This parameter is ignored unless hrResult is S_SYNCMGR_RETRYSYNC.

Return Values

S_OK

The operation completed successfully.

Remarks

pItemIDs is an [in] parameter and the calling function owns the memory pointed to by pItemIDs. SyncMgr makes a copy of the array before returning.

The registered application's handler should return from the ISyncMgrSynchronize::ShowError method as soon as possible and then call this method to notify SyncMgr that it has completed processing the ISyncMgrSynchronize::ShowError call.

It is acceptable for the registered application's handler to call this method before returning from the ISyncMgrSynchronize::ShowError method.

The registered application's handler should not call this method unless a success code is returned from the ISyncMgrSynchronize::Showerror method.

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::ShowError