IBackgroundCopyCallback1::OnStatus 메서드(qmgr.h)

[IBackgroundCopyCallback1 은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 BITS 인터페이스를 사용합니다.]

OnStatus 메서드를 구현하여 그룹이 완료되거나 오류가 발생할 때 알림을 받습니다.

구문

HRESULT OnStatus(
  [in] IBackgroundCopyGroup *pGroup,
  [in] IBackgroundCopyJob1  *pJob,
  [in] DWORD                dwFileIndex,
  [in] DWORD                dwStatus,
  [in] DWORD                dwNumOfRetries,
  [in] DWORD                dwWin32Result,
  [in] DWORD                dwTransportResult
);

매개 변수

[in] pGroup

이벤트를 생성한 그룹에 대한 인터페이스 포인터입니다.

[in] pJob

이벤트가 작업과 연결되지 않은 경우 이벤트 또는 NULL 과 연결된 작업에 대한 인터페이스 포인터입니다.

[in] dwFileIndex

오류 또는 -1과 연결된 파일에 대한 인덱스입니다. 파일을 검색하려면 IBackgroundCopyJob1::GetFile 메서드를 호출합니다.

[in] dwStatus

그룹의 상태입니다. 그룹의 상태가 완료되었거나(그룹의 모든 작업이 다운로드됨) 오류가 발생했습니다. QM_STATUS_GROUP_ERROR 플래그가 설정된 경우 오류가 발생했습니다. 그렇지 않으면 그룹이 완료됩니다.

[in] dwNumOfRetries

오류가 발생한 후 QMGR이 그룹을 다운로드하려고 시도한 횟수입니다. QM_STATUS_GROUP_ERROR dwStatus 플래그가 설정된 경우에만 유효합니다.

[in] dwWin32Result

Win32 오류 코드입니다. QM_STATUS_GROUP_ERROR dwStatus 플래그가 설정된 경우에만 유효합니다.

[in] dwTransportResult

HTTP 오류 코드입니다. QM_STATUS_GROUP_ERROR dwStatus 플래그가 설정된 경우에만 유효합니다.

반환 값

이 메서드는 S_OK 반환해야 합니다. 그렇지 않으면 서비스는 S_OK 반환될 때까지 이 메서드를 계속 호출합니다. 구현이 호출되는 간격은 임의입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP
지원되는 최소 서버	Windows Server 2003
대상 플랫폼	Windows
헤더	qmgr.h

추가 정보

IBackgroundCopyCallback1