IReconcileInitiator ::SetProgressFeedback, méthode (réconciliation.h)
Indique la progression du rapprochement de porte-documents. La quantité est une fraction et est calculée en tant que quotient des paramètres ulProgress et ulProgressMax . Les rapprochements doivent appeler cette méthode régulièrement pendant leur processus de rapprochement.
Syntaxe
HRESULT SetProgressFeedback(
ULONG ulProgress,
ULONG ulProgressMax
);
Paramètres
ulProgress
Type : ULONG
Numérateur de la fraction de progression.
ulProgressMax
Type : ULONG
Dénominateur de la fraction de progression.
Valeur retournée
Type : HRESULT
Retourne la valeur S_OK en cas de réussite, ou la valeur E_UNEXPECTED si une erreur non spécifiée s’est produite.
Remarques
L’initiateur utilise généralement cette mesure de progression pour mettre à jour une jauge de thermomètre ou une autre forme de commentaires visuels pour l’utilisateur. Le rapprochement de porte-documents peut modifier la valeur de ulProgressMax d’un appel à l’autre. Cela signifie que les appels successifs à cette méthode n’indiquent pas nécessairement une progression continue vers l’avant. Le progrès en arrière est légal, mais pas souhaitable. Il incombe à l’initiateur de déterminer si la progression vers l’arrière doit être révélée à l’utilisateur.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | réconciliation.h |
| DLL | Shell32.dll (version 4.0 ou ultérieure) |