IBackgroundCopyJob::SetNotifyInterface 메서드
배달 최적화에 대한 IBackgroundCopyCallback 인터페이스의 구현을 식별합니다. IBackgroundCopyCallback 인터페이스를 사용하여 작업 관련 이벤트에 대한 알림을 받습니다.
구문
HRESULT SetNotifyInterface(
IUnknown *pNotifyInterface
);
매개 변수
-
pNotifyInterface
-
IBackgroundCopyCallback 인터페이스 포인터입니다. 현재 콜백 인터페이스 포인터를 제거하려면 이 매개 변수를 NULL로 설정합니다.
반환 값
이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
알림 인터페이스 포인터가 성공적으로 설정되었습니다. |
설명
IBackgroundCopyCallback 인터페이스를 구현하는 경우에만 이 메서드를 호출합니다. SetNotifyFlags 메서드와 함께 SetNotifyInterface 메서드를 사용하여 수신할 알림 유형을 지정합니다.
애플리케이션이 종료되면 알림 인터페이스가 유효하지 않습니다. 배달 최적화는 알림 인터페이스를 유지하지 않습니다. 따라서 애플리케이션의 초기화 프로세스는 알림을 수신하려는 기존 작업에서 SetNotifyInterface 메서드를 호출해야 합니다. 애플리케이션이 마지막으로 실행된 이후 발생한 상태 및 진행률 정보를 캡처해야 하는 경우 애플리케이션 초기화 중에 상태 및 진행률 정보를 폴링합니다.
작업 소유자/작성자 또는 관리자만 알림을 등록할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 10 버전 1709 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server, 버전 1709 [데스크톱 앱만 해당] |
| 헤더 |
|
| IDL |
|
| 라이브러리 |
|
| DLL |
|
| IID |
IID_IBackgroundCopyJob 37668D37-507E-4160-9316-26306D150B12로 정의됩니다. |