Partager via


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
S_OK
Le travail a été annulé avec succès.
BG_S_UNABLE_TO_DELETE_FILES
Le travail a été annulé avec succès ; toutefois, le service n’a pas pu supprimer les fichiers temporaires associés au travail.
BG_E_INVALID_STATE
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

Voir aussi

IBackgroundCopyJob ::Complete

IBackgroundCopyJob ::Resume

IBackgroundCopyJob ::Suspend