ISyncMgrSynchronize::Initialize, méthode (mobsync.h)
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 |
|---|---|
|
L’initialisation a réussi. |
|
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 |