Méthode IBackgroundCopyJob ::Cancel (bits.h)
Supprime le travail de la file d’attente de transfert et supprime les fichiers temporaires associés du client (téléchargements) et du serveur (chargements).
Syntaxe
HRESULT Cancel();
Valeur de retour
Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.
| Code de retour | Description |
|---|---|
|
Le travail a été annulé avec succès. |
|
Le travail a été annulé avec succès ; toutefois, le service n’a pas pu supprimer les fichiers temporaires associés au travail. |
|
Impossible d’annuler un travail dont l’état est BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED. |
Remarques
Vous pouvez annuler un travail à tout moment ; toutefois, le travail ne peut pas être récupéré après son annulation.
Pour les travaux de chargement, si le serveur n’est pas disponible, il peut y avoir un délai avant que BITS supprime le travail de la file d’attente. BITS envoie régulièrement une demande d’annulation au serveur BITS pendant 24 heures maximum. Si le serveur ne répond pas dans la période de 24 heures, BITS supprime le travail de la file d’attente. Si le délai d’attente sans progression est inférieur à 24 heures, BITS utilise le délai d’attente sans progression pour limiter les nouvelles tentatives.
La méthode Cancel annule un chargement si le chargement n’est pas terminé. Si le chargement est terminé et que le travail est de type BG_JOB_TYPE_UPLOAD_REPLY, la méthode annule la réponse.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP |
| Serveur minimal pris en charge | Windows Server 2003 |
| Plateforme cible | Windows |
| En-tête | bits.h |
| Bibliothèque | Bits.lib |
| DLL | QmgrPrxy.dll |