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