IBackgroundCopyCallback :: JobError, méthode

L’optimisation de la distribution appelle votre implémentation de la méthode JobError lorsque l’état du travail passe à BG_JOB_STATE_ERROR.

Syntaxe

HRESULT JobError(
  [in] IBackgroundCopyJob   *pJob,
  [in] IBackgroundCopyError *pError
);

Paramètres

pJob [ dans]

Contient des informations relatives au travail, telles que le nombre d’octets et de fichiers transférés avant l’erreur. Elle contient également les méthodes de reprise et d’annulation du travail. Ne libérez pas pJob; L’optimisation de la distribution libère l’interface lorsque la méthode JobError est retournée.

perror [ dans]

Contient des informations sur l’erreur, telles que le fichier en cours de traitement au moment où l’erreur irrécupérable s’est produite et une description de l’erreur. Ne libérez pas perror; L’optimisation de la distribution libère l’interface lorsque la méthode JobError est retournée.

Valeur de retour

Cette méthode doit retourner S_OK; Sinon, l’optimisation de la remise continue à appeler cette méthode jusqu’à ce que S_OK soit retourné. Pour des raisons de performances, vous devez limiter le nombre de fois où vous retournez une valeur autre que S_OK à plusieurs fois. Au lieu de retourner un code d’erreur, envisagez de retourner toujours S_OK et de gérer l’erreur en interne. L’intervalle auquel cette méthode est appelée est arbitraire.

Remarques

Après avoir déterminé la cause de l’erreur, effectuez l’une des options suivantes :

Les erreurs temporaires ne génèrent pas d’appels à la méthode JobError .

L’optimisation de la remise retourne BG_ERROR_CONTEXT_REMOTE_FILE si le travail atteint une erreur HTTP 403, BG_ERROR_CONTEXT_NONE dans le cas contraire.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 10, les applications de bureau version 1709 [ uniquement]
Serveur minimal pris en charge
Windows Serveur, version 1709 [ applications de bureau uniquement]
En-tête
Deliveryoptimization. h
MIDL
DeliveryOptimization. idl
Bibliothèque
Dosvc. lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyCallback est défini en tant que 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22

Voir aussi

IBackgroundCopyCallback

IBackgroundCopyError

Méthode ibackgroundcopyjob

Méthode ibackgroundcopyjob :: Cancel

Méthode ibackgroundcopyjob :: Resume