ISyncMgrSynchronize::Initialize-Methode (mobsync.h)
Wird vom Synchronisierungs-Manager in einem registrierten Anwendungshandler aufgerufen, um zu bestimmen, ob der Handler das Synchronisierungsereignis verarbeitet.
Syntax
HRESULT Initialize(
[in] DWORD dwReserved,
[in] DWORD dwSyncMgrFlags,
[in] DWORD cbCookie,
[in] const BYTE *lpCookie
);
Parameter
[in] dwReserved
Art: DWORD
Reserviert; muss 0 (null) sein.
[in] dwSyncMgrFlags
Art: DWORD
Die SYNCMGRFLAG-Enumerationswerte , die beschreiben, wie ein Synchronisierungsereignis initiiert wird.
[in] cbCookie
Art: DWORD
Die Größe der lpCookie-Daten in Bytes.
[in] lpCookie
Typ: BYTE const*
Ein Zeiger auf das Token, das eine Anwendung identifiziert. Dieses Token wird übergeben, wenn eine Anwendung den Synchronisierungs-Manager programmgesteuert aufruft.
Rückgabewert
Typ: HRESULT
Diese Methode unterstützt die standardmäßigen Rückgabewerte E_INVALIDARG, E_UNEXPECTED und E_OUTOFMEMORY sowie folgendes.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Initialisierung ist erfolgreich. |
|
Der Anwendungshandler verarbeitet kein Synchronisierungsereignis. |
Hinweise
Die SYNCMGRFLAG-Enumerationswerte gelten über die Lebensdauer der ISyncMgrSynchronize-Schnittstelle und werden von den anderen ISyncMgrSynchronize-Methoden verwendet.
Wenn eine Anwendung das SYNCMGRFLAG-Ereignis nicht erkennt, sollte die Anwendung das Ereignis als manuelle Synchronisierung behandeln.
Ein registrierter Anwendungshandler kann keine Benutzeroberfläche innerhalb dieses Aufrufs anzeigen, es sei denn, die Initialisierungsmethode wird zum ersten Mal aufgerufen. Eine Anwendung kann jede einmalige Initialisierung anzeigen, die sie zum Einrichten von Elementen und zum Einführen eines Anwendungsfeatures für einen Benutzer benötigt. Wenn Sie eine Benutzeroberfläche aus einem anderen Grund als Teil des Synchronisierungsprozesses anzeigen müssen, können Sie die ISyncMgrSynchronize::P repareForSync-Methode verwenden.
Der lpCookie-Parameter ist NULL , es sei denn, eine behandelnde Anwendung ruft den Synchronisierungs-Manager programmgesteuert mithilfe von UpdateItems auf. In diesem Szenario identifiziert der Klassenbezeichner (CLSID) die behandlungsbezogene Anwendung, und der Wert von lpCookie wird von der behandlungsbezogenen Anwendung übergeben und dann während der Synchronisierung für den Kontext vom Synchronisierungs-Manager zurückgegeben. Der lpCookie-Parameter ist nur sinnvoll, wenn SYNCMGRFLAG_INVOKE festgelegt ist.
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 |