Méthode IBackgroundCopyCallback ::JobModification (bits.h)

Article
02/23/2024

BITS appelle votre implémentation de la méthode JobModification lorsque le travail a été modifié. Le service génère cet événement lorsque des octets sont transférés, que des fichiers ont été ajoutés au travail, que des propriétés ont été modifiées ou que l’état du travail a changé.

Syntaxe

HRESULT JobModification(
  [in] IBackgroundCopyJob *pJob,
  [in] DWORD              dwReserved
);

Paramètres

[in] pJob

Contient les méthodes permettant d’accéder aux informations de propriété, de progression et d’état du travail. Ne relâchez pas pJob ; BITS libère l’interface lorsque la méthode JobModification retourne.

[in] dwReserved

Réservé pour un usage futur.

Valeur retournée

Cette méthode doit retourner S_OK.

Remarques

Votre implémentation peut ne pas recevoir tous les événements de modification dans des conditions de charge maximale des ressources.

BITS génère un volume élevé d’événements de modification ; envisagez de créer un minuteur et d’interroger les informations d’état et de progression ou de limiter votre utilisation de ce rappel. Si vous utilisez ce rappel, gardez votre implémentation courte.

BITS ne génère pas d’événement de modification lorsque l’état du travail devient BG_JOB_STATE_ERROR ou BG_JOB_STATE_TRANSFERRED.

Note BITS prend en charge jusqu’à quatre notifications simultanées par utilisateur. Si une ou plusieurs applications bloquent le retour des quatre notifications d’un utilisateur, une application s’exécutant en tant qu’utilisateur ne recevra pas de notifications tant qu’une ou plusieurs notifications de blocage ne seront pas retournées.

Exemples

Consultez l’exemple de code de l’interface IBackgroundCopyCallback .

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

Voir aussi

IBackgroundCopyCallback

IBackgroundCopyJob

Partager via