ISyncMgrSynchronize::ShowError method
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
- hWndParent [in]
-
Type: HWND
A handle to the parent HWND that a registered application should use to display a user interface. This value can be NULL.
- ErrorID [in]
-
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 |
|---|---|
|
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
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
DLL |
|
See also
- SYNCMGRFLAG
- ISyncMgrSynchronize
- EnableModeless
- LogError
- ShowErrorCompleted
- ISyncMgrSynchronize::Initialize