Méthode ISimilarityReportProgress ::ReportProgress (msrdc.h)
Indique le pourcentage d’achèvement actuel d’une opération de similarité en cours.
Syntaxe
HRESULT ReportProgress(
[in] DWORD percentCompleted
);
Paramètres
[in] percentCompleted
Pourcentage d’achèvement actuel de la tâche. La plage valide est comprise entre 0 et 100.
Valeur retournée
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
La méthode ISimilarity ::CopyAndSwap appelle la méthode ReportProgress pour signaler la progression de l’opération de copie et d’échange. Pour recevoir les informations de progression, les applications RDC doivent implémenter cette méthode.
Aucune garantie n’est faite quant à la fréquence d’appel de cette méthode, ni qu’elle sera appelée avec des valeurs spécifiques pour le paramètre percentCompleted . Par exemple, le paramètre percentCompleted peut ne pas commencer à zéro et ne jamais atteindre 100, et il peut recevoir la même valeur plusieurs fois. Toutefois, chaque valeur est garantie supérieure ou égale à la valeur précédente.
Si l’application retourne un code d’erreur tel que E_FAIL, l’opération de similarité est arrêtée et le code d’erreur est propagé.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista |
Serveur minimal pris en charge | Windows Server 2008 |
Plateforme cible | Windows |
En-tête | msrdc.h |
DLL | MsRdc.dll |