ISyncMgrSynchronize::ShowError

The Synchronization Manager calls the ISyncMgrSynchronize::ShowError method in a registered application's handler when the user double-clicks on the associated message in the error tab.

HRESULT ShowError(
  HWND hWndParent,       // Parent hWnd for user interface
  DWORD dwErrorID        // Error identifier
);

Parameters

hWndParent

[in] Handle to the parent hWndt the registered application should use to display the user interface. This value may be NULL.

dwErrorID

[in] Error identifier associated with this error message. The ErrorID value is passed in the ISyncMgrSynchronizeCallback::LogError method.

Return Values

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

S_OK

Call completed successfully.

Remarks

Handlers should return as soon as possible from this method and call the ISyncMgrSynchronizeCallback::ShowErrorCompleted method. It is acceptable for the handler to make a call to ISyncMgrSynchronizeCallback::ShowErrorCompleted before returning from this method. If a handler returns a failure code from this method, it should not call the ISyncMgrSynchronizeCallback::ShowErrorCompleted method.

Applications may display user interface elements in this method even if the SYNCMGRFLAG_MAYBOTHERUSER was not set in the dwSyncFlags parameter of the ISyncMgrSynchronize::Initialize method. Applications must still call ISyncMgrSynchronizeCallback::EnableModeless and check the return code before showing user interface.

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

ISyncMgrSynchronizeCallback::EnableModeless, ISyncMgrSynchronizeCallback::LogError, ISyncMgrSynchronizeCallback::ShowErrorCompleted, ISyncMgrSynchronize::Initialize, SYNCMGRFLAG