Méthode ISyncMgrSynchronize::P repareForSync (mobsync.h)

Article
08/24/2023

Permet à une application inscrite d’afficher n’importe quelle interface utilisateur et d’effectuer toute initialisation nécessaire avant l’appel de la méthode ISyncMgrSynchronize::Synchronize . Par exemple, une application telle que le client de messagerie Microsoft Outlook peut avoir besoin d’afficher la boîte de dialogue mot de passe pour permettre à un utilisateur de se connecter à un serveur de messagerie.

Syntaxe

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

Paramètres

[in] cbNumItems

Type : ULONG

Nombre d’éléments dans le tableau pointés par des pItemID.

[in] pItemIDs

Type : GUID*

Tableau d’ID d’élément qu’un utilisateur choisit de synchroniser.

[in] hWndParent

Type : HWND

Handle du HWND parent qu’une application inscrite doit utiliser pour tout élément d’interface utilisateur affiché. Cette valeur peut être NULL.

[in] dwReserved

Type : DWORD

Réservé. Les applications inscrites doivent ignorer cette valeur.

Valeur retournée

Type : HRESULT

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

Code de retour	Description
S_OK	La préparation est réussie.

Notes

Un gestionnaire d’application inscrit doit revenir à partir de cette méthode dès que possible, puis appeler la méthode PrepareForSyncCompleted . Un gestionnaire d’application inscrit peut appeler la méthode PrepareForSyncCompleted avant de retourner à partir de cette méthode.

Les applications inscrites doivent uniquement afficher une interface utilisateur si l’indicateur SYNCMGRFLAG_MAYBOTHERUSER est défini dans le paramètre dwSyncFlags de la méthode ISyncMgrSynchronize::Initialize . Si une application inscrite ne peut pas se préparer à la synchronisation sans afficher une interface utilisateur lorsque l’indicateur SYNCMGRFLAG_MAYBOTHERUSER n’est pas défini, elle doit retourner S_FALSE de cette méthode.

Le tableau d’ID d’élément transmis à cette méthode est également pertinent pour la méthode ISyncMgrSynchronize::Synchronize .

Les méthodes ISyncMgrSynchronizeCallback peuvent être appelées sur n’importe quel thread d’une application inscrite.

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