ISyncMgrSynchronize::Initialize, méthode (mobsync.h)

  • Article

Appelé par le gestionnaire de synchronisation dans un gestionnaire d’application inscrit pour déterminer si le gestionnaire traite l’événement de synchronisation.

Syntaxe

HRESULT Initialize(
  [in] DWORD      dwReserved,
  [in] DWORD      dwSyncMgrFlags,
  [in] DWORD      cbCookie,
  [in] const BYTE *lpCookie
);

Paramètres

[in] dwReserved

Type : DWORD

Réservés au; doit être égal à 0 (zéro).

[in] dwSyncMgrFlags

Type : DWORD

Valeurs d’énumération SYNCMGRFLAG qui décrivent comment un événement de synchronisation est lancé.

[in] cbCookie

Type : DWORD

Taille des données lpCookie , en octets.

[in] lpCookie

Type : BYTE const*

Pointeur vers le jeton qui identifie une application. Ce jeton est passé lorsqu’une application appelle le gestionnaire de synchronisation par programmation.

Valeur retournée

Type : HRESULT

Cette méthode prend en charge les valeurs de retour standard E_INVALIDARG, E_UNEXPECTED et E_OUTOFMEMORY, et les éléments suivants.

Code de retour Description
S_OK
 L’initialisation a réussi.
S_FALSE
 Le gestionnaire d’application ne traite pas d’événement de synchronisation.

Notes

Les valeurs d’énumération SYNCMGRFLAG s’appliquent pendant toute la durée de vie de l’interface ISyncMgrSynchronize et sont utilisées par les autres méthodes ISyncMgrSynchronize .

Si une application ne reconnaît pas l’événement SYNCMGRFLAG , l’application doit traiter l’événement comme une synchronisation manuelle.

Un gestionnaire d’application inscrit ne peut pas afficher une interface utilisateur dans cet appel, sauf si c’est la première fois que la méthode d’initialisation est appelée. Une application peut afficher toute initialisation unique dont elle a besoin pour configurer des éléments et introduire un utilisateur à une fonctionnalité d’application. Si vous devez afficher une interface utilisateur pour une autre raison dans le cadre du processus de synchronisation, vous pouvez utiliser la méthode ISyncMgrSynchronize::P repareForSync .

Le paramètre lpCookie est NULL , sauf si une application de gestion appelle le gestionnaire de synchronisation par programmation à l’aide de UpdateItems. Dans ce scénario, l’identificateur de classe (CLSID) identifie l’application de gestion, et la valeur de lpCookie est transmise par l’application de gestion, puis renvoyée par le gestionnaire de synchronisation pendant la synchronisation pour le contexte. Le paramètre lpCookie n’est significatif que lorsque SYNCMGRFLAG_INVOKE est défini.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête mobsync.h
DLL Mobsync.dll

Voir aussi

ISyncMgrSynchronize

ISyncMgrSynchronize::P repareForSync

SYNCMGRFLAG

UpdateItems