Share via


Méthode IBackgroundCopyJob ::GetErrorCount (bits.h)

Récupère le nombre de fois où BITS a tenté de transférer le travail et qu’une erreur s’est produite.

Syntaxe

HRESULT GetErrorCount(
  [out] ULONG *Errors
);

Paramètres

[out] Errors

Nombre d’erreurs qui se sont produites pendant que BITS a essayé de transférer le travail. Le nombre augmente lorsque le travail passe de l’état BG_JOB_STATE_TRANSFERRING à l’état BG_JOB_STATE_TRANSIENT_ERROR ou BG_JOB_STATE_ERROR.

Valeur retournée

Cette méthode retourne S_OK sur la réussite ou l’une des valeurs COM HRESULT standard en cas d’erreur.

Remarques

Le nombre n’est jamais réinitialisé. Le nombre peut ne pas refléter avec précision le nombre de fois où le travail passe à l’état d’erreur temporaire ou d’erreur. Par exemple, BITS n’augmente pas le nombre lorsque des déconnexions réseau se produisent, que le programme de disque case activée s’exécute ou que la stratégie de bande passante empêche le transfert des travaux.

BITS augmente également le nombre chaque fois qu’il tente de transférer le travail lorsque le travail est dans l’état d’erreur temporaire et que le travail échoue.

BITS 1.5 et versions antérieures : BITS n’augmente pas le nombre chaque fois qu’il tente de transférer le travail lorsqu’il est dans l’état d’erreur temporaire.

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 ::GetError