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.

Beispiele

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

Anforderungen

Weitere Informationen

IBackgroundCopyCallback

IBackgroundCopyJob