IBackgroundCopyJob 인터페이스
IBackgroundCopyJob 인터페이스를 사용하여 작업에 파일을 추가하고, 작업의 우선 순위 수준을 설정하고, 작업 상태를 확인하고, 작업을 시작 및 중지합니다.
작업을 만들려면 IBackgroundCopyManager::CreateJob 메서드를 호출합니다. 기존 작업에 대한 IBackgroundCopyJob 인터페이스 포인터를 얻으려면 IBackgroundCopyManager::GetJob 메서드를 호출합니다.
멤버
IBackgroundCopyJob 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IBackgroundCopyJob 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IBackgroundCopyJob 인터페이스에는 이러한 메서드가 있습니다.
| 메서드 | 설명 |
|---|---|
| 취소 | 작업을 취소하고 클라이언트에서 임시 파일을 제거합니다. |
| 완료 | 작업을 종료하고 전송된 파일을 클라이언트에 저장합니다. |
| EnumFiles | 작업의 파일을 열거하는 데 사용하는 열거자 개체에 대한 인터페이스 포인터를 반환합니다. |
| GetDisplayName | 작업을 식별하는 표시 이름을 검색합니다. |
| GetError | 오류가 발생한 후 오류 개체에 대한 인터페이스 포인터를 검색합니다. |
| GetId | 큐에서 작업의 식별자를 검색합니다. |
| GetNoProgressTimeout | 일시적인 오류 조건이 발생한 후 배달 최적화에서 파일 전송을 계속 시도하는 시간을 검색합니다. |
| GetNotifyFlags | 애플리케이션에 대해 설정한 이벤트 알림(콜백) 플래그를 검색합니다. |
| GetNotifyInterface |
IBackgroundCopyCallback 인터페이스(콜백)의 구현에 대한 포인터를 검색합니다. |
| GetPriority | 작업에 대해 설정한 우선 순위 수준을 검색합니다. |
| GetProgress | 클라이언트로 전송된 바이트 및 파일 수와 같은 작업 관련 진행률 정보를 검색합니다. |
| GetState | 작업의 상태를 검색합니다. |
| GetTimes | 작업이 만들어진 시간과 같이 작업과 관련된 활동에 대한 타임스탬프를 검색합니다. |
| Gettype | 파일 다운로드와 같이 수행되는 전송 유형을 검색합니다. |
| 다시 시작 | 새 작업을 시작하거나 일시 중단된 작업을 다시 시작합니다. |
| SetNoProgressTimeout | 일시적인 오류 조건이 발생한 후 배달 최적화에서 파일 전송을 계속 시도하는 기간을 지정합니다. |
| SetNotifyFlags | 수신할 이벤트 알림의 유형을 지정합니다. |
| SetNotifyInterface |
IBackgroundCopyCallback 인터페이스(콜백)의 구현에 대한 포인터를 지정합니다. 인터페이스는 설정한 이벤트 알림 플래그에 따라 알림을 받습니다. |
| SetPriority | 전송 큐의 다른 작업을 기준으로 작업의 우선 순위를 지정합니다. |
| 일시 중지됨 | 작업을 일시 중지합니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 10 버전 1709 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 버전 1709 [데스크톱 앱만 해당] |
| 헤더 |
|
| IDL |
|
| 라이브러리 |
|
| DLL |
|
| IID |
IID_IBackgroundCopyJob 37668D37-507E-4160-9316-26306D150B12로 정의됩니다. |