Interface IXtfDeployCallback
Fournit un rappel qui est appelé lorsqu’une action pouvant être suivie se produit pendant une opération IXtfApplicationClient::Deploy.Syntaxe
Méthodes
Remarques
Toutes les méthodes de rappel fonctionnent de la même manière en ce qui concerne leurs valeurs de retour. Si un rappel retourne un HResult de réussite, le processus de déploiement se poursuit. Si un rappel retourne un HResult d’échec, quel qu’il soit, le processus de déploiement est annulé immédiatement. Les fichiers qui ont déjà été transférés ou supprimés restent tels quels, et les fichiers partiellement transférés sont fermés dans leur forme tronquée. Le processus de rappel est simple. Chaque fichier sur le PC de développement qui effectue le déploiement est comparé au fichier correspondant sur la console cible.- Si un fichier est identique sur le PC et sur la console, rien de plus n’est fait.
- Si un fichier sur le PC est plus récent que le fichier sur la console, le fichier est copié du PC vers la console.
- Si un fichier existe sur le PC et n’est pas sur la console, il est copié sur la console.
- Si un fichier existe sur la console, mais pas sur le PC, il est éventuellement supprimé de la console. (Sa suppression est déterminée par la valeur du paramètre fRemoveExtraFiles de Deploy).
- OnDeployInitialized : Ce rappel est appelé lorsque le système de déploiement a été engagé et peut être utilisé pour commencer à chronométrer le déploiement ou pour initialiser des boîtes de dialogue de progression. Lorsque ce rappel a été appelé, tous les franchissements potentiels de frontières d’interopérabilité et de DLL ont été effectués avec succès. Ce rappel est appelé une fois par déploiement.
- OnDeployChangeEvaluation : Ce rappel est appelé lorsque le système de déploiement évalue quels fichiers doivent être déployés vers la console ou supprimés de la console. Vous pouvez utiliser ce rappel pour mettre à jour un indicateur de progression.
- OnDeployMetrics : Ce rappel est appelé une fois à la fin du processus d’évaluation, pour signaler le nombre de fichiers qui seront déployés vers la console et le nombre total d’octets à transférer.
- OnDeployFileProgress : Ce rappel est appelé chaque fois qu’un bloc de mémoire tampon est transféré avec succès, pour chaque fichier. Les transferts sont effectués simultanément sur plusieurs threads; votre code doit donc s’assurer de suivre la progression par nom de fichier et se protéger contre les problèmes habituels de multithreading. Ce rappel est appelé une fois au début d’un transfert et une fois à la fin du transfert; un fichier de longueur nulle entraînera donc deux appels de ce rappel.
- OnDeployExtraFileDetected : Indique qu’un fichier a été trouvé sur la console alors qu’il n’est pas sur le PC.
- OnDeployExtraFileRemoved : Si le paramètre fRemoveExtraFiles de Deploy a été défini à TRUE, ce rappel est appelé lorsqu’un fichier est supprimé de la console.
- OnDeployError n’est pas utilisé par l’implémentation actuelle, mais est réservé à un usage futur.