ISyncMgrSynchronize::ShowError method (mobsync.h)

Article
02/22/2024

Called by the synchronization manager in a registered application handler when a user double-clicks an associated message in the error tab.

Syntax

HRESULT ShowError(
  [in] HWND    hWndParent,
  [in] REFGUID ErrorID
);

Parameters

[in] hWndParent

Type: HWND

A handle to the parent HWND that a registered application should use to display a user interface. This value can be NULL.

[in] ErrorID

Type: REFGUID

An error identifier that is associated with this error message. This value is passed in the LogError method.

Return value

Type: HRESULT

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

Return code	Description
S_OK	The call is completed successfully.

Remarks

Handlers should return as soon as possible from this method, and call the ShowErrorCompleted method. A handler can make a call to ShowErrorCompleted before returning from this method. If a handler returns a failure code from this method, it should not call the ShowErrorCompleted method.

Applications can display user interface elements in this method even if the SYNCMGRFLAG_MAYBOTHERUSER flag is not set in the dwSyncFlags parameter of the ISyncMgrSynchronize::Initialize method. Applications must still call EnableModeless, and check the return code before showing a user interface.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	mobsync.h
DLL	Mobsync.dll