IBackgroundCopyCallback1 인터페이스(qmgr.h)

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

이벤트가 발생할 때 알림을 수신하도록 IBackgroundCopyCallback1 인터페이스를 구현합니다. 애플리케이션은 그룹의 상태에 대해 폴링하는 옵션으로 이 인터페이스를 사용합니다.

알림을 받으려면 IBackgroundCopyGroup::SetProp 메서드를 호출하여 GROUPPROP_NOTIFYCLSID 및 GROUPPROP_NOTIFYFLAGS 속성을 설정합니다.

QMGR은 유효한 동안 인터페이스 포인터를 사용합니다(애플리케이션이 종료될 때 인터페이스 포인터가 유효하지 않음). 애플리케이션이 다시 시작되면 QMGR이 여전히 처리 중인 그룹에서 GROUPPROP_NOTIFYCLSID 속성을 다시 설정해야 합니다.

참고 QMGR은 클라이언트 프로세스의 scope 내에서 새 개체를 활성화합니다. 알림은 자체 프로세스에서 실행되지 않습니다. QMGR은 해당 CLSID의 새 개체를 만들고 인터페이스 포인터를 BITS에 전달합니다.

IBackgroundCopyCallback1 인터페이스의 모든 메서드를 구현해야 합니다. 최소한 메서드는 S_OK 반환해야 합니다. 콜백이 BITS를 차단할 가능성을 줄이려면 구현을 짧게 유지합니다.

관리자가 그룹의 소유권을 가져오는 경우 알림을 요청한 사용자의 컨텍스트에서 알림 콜백이 만들어집니다.

상속

IBackgroundCopyCallback1 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IBackgroundCopyCallback1 에는 다음과 같은 유형의 멤버도 있습니다.

IBackgroundCopyCallback1 인터페이스에는 이러한 메서드가 있습니다.


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