Méthode ISyncMgrSynchronize::P repareForSync (mobsync.h)
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 |
---|---|
|
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 |
Voir aussi
ISyncMgrSynchronize::Initialize
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour