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는 수정 이벤트를 생성하지 않습니다.

참고 BITS는 사용자당 최대 4개의 동시 알림을 지원합니다. 하나 이상의 애플리케이션이 사용자의 4개 알림 모두 반환을 차단하는 경우 하나 이상의 차단 알림이 반환될 때까지 동일한 사용자로 실행되는 애플리케이션은 알림을 받지 않습니다.

IBackgroundCopyCallback 인터페이스에 대한 예제 코드를 참조하세요.