ISyncMgrSynchronize::P repareForSync-Methode (mobsync.h)

2023-08-24

Ermöglicht einer registrierten Anwendung, eine beliebige Benutzeroberfläche anzuzeigen und alle erforderlichen Initialisierungen auszuführen, bevor die ISyncMgrSynchronize::Synchronize-Methode aufgerufen wird. Beispielsweise muss eine Anwendung wie der Microsoft Outlook-E-Mail-Client möglicherweise das Kennwortdialogfeld anzeigen, damit sich ein Benutzer bei einem E-Mail-Server anmelden kann.

Syntax

HRESULT PrepareForSync(
  [in] ULONG cbNumItems,
  [in] GUID  *pItemIDs,
  [in] HWND  hWndParent,
  [in] DWORD dwReserved
);

Parameter

[in] cbNumItems

Typ: ULONG

Die Anzahl der Elemente im Array, auf die von pItemIDs verwiesen wird.

[in] pItemIDs

Typ: GUID*

Ein Array von Element-IDs, die ein Benutzer für die Synchronisierung auswäht.

[in] hWndParent

Typ: HWND

Ein Handle für den übergeordneten HWND , den eine registrierte Anwendung für jedes angezeigte Benutzeroberflächenelement verwenden sollte. Dieser Wert kann NULL sein.

[in] dwReserved

Art: DWORD

Reserviert. Registrierte Anwendungen sollten diesen Wert ignorieren.

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	Die Vorbereitung ist erfolgreich.

Hinweise

Ein registrierter Anwendungshandler sollte von dieser Methode so schnell wie möglich zurückgegeben und dann die PrepareForSyncCompleted-Methode aufrufen. Ein registrierter Anwendungshandler kann die PrepareForSyncCompleted-Methode aufrufen, bevor er von dieser Methode zurückgibt.

Registrierte Anwendungen sollten nur dann eine Benutzeroberfläche anzeigen, wenn das SYNCMGRFLAG_MAYBOTHERUSER-Flag im dwSyncFlags-Parameter der ISyncMgrSynchronize::Initialize-Methode festgelegt ist. Wenn eine registrierte Anwendung die Synchronisierung nicht vorbereiten kann, ohne eine Benutzeroberfläche anzuzeigen, wenn das SYNCMGRFLAG_MAYBOTHERUSER-Flag nicht festgelegt ist, sollte sie S_FALSE von dieser Methode zurückgeben.

Das Array von Element-IDs, die an diese Methode übergeben werden, sind auch für die ISyncMgrSynchronize::Synchronize-Methode relevant.

Die ISyncMgrSynchronizeCallback-Methoden können für jeden Thread in einer registrierten Anwendung aufgerufen werden.

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