IBackgroundCopyCallback::JobModification-Methode (bits.h)

BITS ruft Ihre Implementierung der JobModification-Methode auf, wenn der Auftrag geändert wurde. Der Dienst generiert dieses Ereignis, wenn Bytes übertragen, Dateien dem Auftrag hinzugefügt, Eigenschaften geändert wurden oder sich der Status des Auftrags geändert hat.

Syntax

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

Parameter

[in] pJob

Enthält die Methoden für den Zugriff auf Eigenschaften-, Status- und Zustandsinformationen des Auftrags. Geben Sie pJob nicht frei. BITS gibt die Schnittstelle frei, wenn die JobModification-Methode zurückgibt.

[in] dwReserved

Für die zukünftige Verwendung reserviert.

Rückgabewert

Diese Methode sollte S_OK zurückgeben.

Hinweise

Ihre Implementierung empfängt möglicherweise nicht alle Änderungsereignisse unter bedingungen der maximalen Ressourcenauslastung.

BITS generiert eine große Menge an Änderungsereignissen. Erwägen Sie, einen Timer zu erstellen und Zustands- und Statusinformationen abzurufen, oder beschränken Sie die Verwendung dieses Rückrufs. Wenn Sie diesen Rückruf verwenden, halten Sie Ihre Implementierung kurz.

BITS generiert kein Änderungsereignis, wenn sich der Status des Auftrags in BG_JOB_STATE_ERROR oder BG_JOB_STATE_TRANSFERRED ändert.

Hinweis BITS unterstützt bis zu vier gleichzeitige Benachrichtigungen pro Benutzer. Wenn eine oder mehrere Anwendungen verhindern, dass alle vier Benachrichtigungen für einen Benutzer zurückgegeben werden, erhält eine Anwendung, die als derselbe Benutzer ausgeführt wird, keine Benachrichtigungen, bis mindestens eine der blockierenden Benachrichtigungen zurückgegeben wird.

 

Beispiele

Sehen Sie sich den Beispielcode für die IBackgroundCopyCallback-Schnittstelle an.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Zielplattform	Windows
Kopfzeile	bits.h

Weitere Informationen

IBackgroundCopyCallback

IBackgroundCopyJob