IBackgroundCopyCallback::JobModification メソッド (bits.h)

BITS は、ジョブが変更されたときに JobModification メソッドの実装を呼び出します。バイトの転送、ジョブへのファイルの追加、プロパティの変更、またはジョブの状態の変更時に、このイベントがサービスによって生成されます。

構文

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

[in] pJob

ジョブのプロパティ、進行状況、および状態情報にアクセスするためのメソッドが含まれます。 pJob を解放しないでください。BITS は、JobModification メソッドが戻るときにインターフェイスを解放します。

[in] dwReserved

将来利用するために予約されています。

このメソッドは 、S_OKを返す必要があります。

実装では、リソースの最大読み込み条件下ですべての変更イベントが受信されない場合があります。

BITS は大量の変更イベントを生成します。状態と進行状況の情報のタイマーとポーリングを作成するか、このコールバックの使用を制限することを検討してください。このコールバックを使用する場合は、実装を短くしてください。

ジョブの状態が BG_JOB_STATE_ERROR または BG_JOB_STATE_TRANSFERRED に変わると、BITS は modify イベントを生成しません。

メモ BITS では、ユーザーごとに最大 4 つの同時通知がサポートされます。 1 つ以上のアプリケーションでユーザーの 4 つの通知すべてが返されないようにブロックされている場合、同じユーザーとして実行されているアプリケーションは、1 つ以上のブロック通知が返されるまで通知を受け取りません。

IBackgroundCopyCallback インターフェイスのコード例を参照してください。