ISyncMgrSynchronize::ShowError-Methode (mobsync.h)

Artikel
08/24/2023

Wird vom Synchronisierungs-Manager in einem registrierten Anwendungshandler aufgerufen, wenn ein Benutzer auf eine zugeordnete Meldung auf der Fehlerregisterkarte doppelklicken.

Syntax

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

Parameter

[in] hWndParent

Typ: HWND

Ein Handle für den übergeordneten HWND , den eine registrierte Anwendung verwenden sollte, um eine Benutzeroberfläche anzuzeigen. Dieser Wert kann NULL sein.

[in] ErrorID

Typ: REFGUID

Ein Fehlerbezeichner, der dieser Fehlermeldung zugeordnet ist. Dieser Wert wird in der LogError-Methode übergeben.

Rückgabewert

Typ: HRESULT

Diese Methode unterstützt die Standardrückgabewerte E_INVALIDARG, E_UNEXPECTED und E_OUTOFMEMORY sowie Folgendes:

Rückgabecode	BESCHREIBUNG
S_OK	Der Aufruf wurde erfolgreich abgeschlossen.

Hinweise

Handler sollten so bald wie möglich von dieser Methode zurückgegeben und die ShowErrorCompleted-Methode aufrufen. Ein Handler kann showErrorCompleted aufrufen, bevor er von dieser Methode zurückgibt. Wenn ein Handler einen Fehlercode von dieser Methode zurückgibt, sollte er die ShowErrorCompleted-Methode nicht aufrufen.

Anwendungen können Benutzeroberflächenelemente in dieser Methode anzeigen, auch wenn das SYNCMGRFLAG_MAYBOTHERUSER-Flag nicht im dwSyncFlags-Parameter der ISyncMgrSynchronize::Initialize-Methode festgelegt ist. Anwendungen müssen weiterhin EnableModeless aufrufen und den Rückgabecode überprüfen, bevor eine Benutzeroberfläche angezeigt wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mobsync.h
DLL	Mobsync.dll