다음을 통해 공유


IBackgroundCopyJob::SetNotifyFlags 메서드(bits.h)

작업 전송 이벤트와 같이 수신하려는 이벤트 알림의 유형을 지정합니다.

구문

HRESULT SetNotifyFlags(
  [in] ULONG Val
);

매개 변수

[in] Val

다음 플래그 중 하나 이상을 설정하여 수신하려는 이벤트를 식별합니다.

의미
BG_NOTIFY_JOB_TRANSFERRED
0x0001
작업의 모든 파일이 전송되었습니다.
BG_NOTIFY_JOB_ERROR
0x0002
오류가 발생했습니다.
BG_NOTIFY_DISABLE
0x0004
이벤트 알림을 사용할 수 없습니다. BITS는 다른 플래그를 무시합니다.
BG_NOTIFY_JOB_MODIFICATION
0x0008
작업이 수정되었습니다. 예를 들어 속성 값이 변경되거나, 작업 상태가 변경되거나, 파일 전송이 진행됩니다. 명령줄 알림이 지정된 경우 명령줄 콜백에서 이 플래그는 무시됩니다.
BG_NOTIFY_FILE_TRANSFERRED
0x0010
작업의 파일이 전송되었습니다. 명령줄 알림이 지정된 경우 명령줄 콜백에서 이 플래그는 무시됩니다.
BG_NOTIFY_FILE_RANGES_TRANSFERRED
0x0020
파일의 바이트 범위가 전송되었습니다. 명령줄 알림이 지정된 경우 명령줄 콜백에서 이 플래그는 무시됩니다. 플래그는 모든 작업에 대해 지정할 수 있지만 BITS_JOB_PROPERTY_ON_DEMAND_MODE 작업에 대한 요구 사항을 충족하는 작업에 대한 알림만 받게 됩니다.

반환 값

이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.

반환 코드 설명
S_OK
이벤트 알림 유형이 성공적으로 설정되었습니다.
E_NOTIMPL
NotifyFlags 값이 잘못되었습니다.
BG_E_INVALID_STATE
작업의 상태는 BG_JOB_STATE_CANCELLED 또는 BG_JOB_STATE_ACKNOWLEDGED 수 없습니다.

설명

이벤트 알림을 받으려면 SetNotifyFlags 메서드를 IBackgroundCopyJob::SetNotifyInterfaceIBackgroundCopyJob2::SetNotifyCmdLine 메서드와 함께 사용합니다.

예제

IBackgroundCopyJob::SetNotifyInterface 메서드에 대한 예제 코드를 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP
지원되는 최소 서버 Windows Server 2003
대상 플랫폼 Windows
헤더 bits.h
라이브러리 Bits.lib
DLL QmgrPrxy.dll

추가 정보

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob2::SetNotifyCmdLine

IBackgroundCopyJob::GetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface