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::SetNotifyInterface 및 IBackgroundCopyJob2::SetNotifyCmdLine 메서드와 함께 사용합니다.

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