Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Supprime le travail de la file d’attente de transfert et supprime les fichiers temporaires associés du client (téléchargements) et serveur (chargements).
Syntaxe
HRESULT Cancel();
Valeur retournée
Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.
| Code de retour | Descriptif |
|---|---|
|
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 ne supprime le travail de la file d’attente. BITS envoie régulièrement une demande d’annulation au serveur BITS pendant jusqu’à 24 heures. Si le serveur ne répond pas pendant 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.
Spécifications
| Requirement | Valeur |
|---|---|
| Client minimum requis | Windows XP |
| Serveur minimal pris en charge | Windows Server 2003 |
| plateforme cible | Fenêtres |
| Header | bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |