ISyncMgrSynchronize::Initialize-Methode (mobsync.h)

  • Artikel

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
S_OK
 Die Initialisierung ist erfolgreich.
S_FALSE
 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

Weitere Informationen

ISyncMgrSynchronize

ISyncMgrSynchronize::P repareForSync

SYNCMGRFLAG

UpdateItems