IXtfDeployCallback 인터페이스
IXtfApplicationClient::Deploy 작업 중에 추적 가능한 동작이 발생할 때 호출되는 콜백을 제공합니다.구문
메서드
설명
모든 콜백 메서드는 반환 값과 관련하여 동일한 방식으로 동작합니다. 콜백이 성공한 HRESULT를 반환하면 배포 프로세스가 계속됩니다. 콜백이 실패한 HRESULT를 반환하면 배포 프로세스가 즉시 취소됩니다. 이미 전송되거나 삭제된 파일은 그대로 유지되며, 부분적으로 전송된 파일은 잘린 형태로 닫힙니다. 콜백 프로세스는 간단합니다. 배포 중인 개발 PC의 각 파일이 대상 콘솔의 해당 파일과 비교됩니다.- 파일이 PC와 콘솔에서 동일하면 더 이상 아무 작업도 수행되지 않습니다.
- PC의 파일이 콘솔의 파일보다 최신이면 파일이 PC에서 콘솔로 복사됩니다.
- 파일이 PC에는 있지만 콘솔에는 없으면 콘솔로 복사됩니다.
- 파일이 콘솔에는 있지만 PC에는 없으면 선택적으로 콘솔에서 삭제됩니다. (삭제 여부는 Deploy의 fRemoveExtraFiles 매개 변수 값에 의해 결정됩니다).
- OnDeployInitialized: 이 콜백은 배포 시스템이 활성화되었을 때 호출되며 배포 시간 측정을 시작하거나 진행률 대화 상자를 초기화하는 데 사용할 수 있습니다. 이 콜백이 호출된 시점에는 모든 잠재적인 상호 운용성 및 DLL 경계 교차가 성공적으로 완료된 상태입니다. 이 콜백은 배포당 한 번 호출됩니다.
- OnDeployChangeEvaluation: 이 콜백은 배포 시스템이 콘솔에 배포하거나 콘솔에서 삭제해야 하는 파일을 평가할 때 호출됩니다. 이 콜백을 사용하여 진행률 표시기를 업데이트할 수 있습니다.
- OnDeployMetrics: 이 콜백은 평가 프로세스가 끝날 때 한 번 호출되며, 콘솔로 배포될 파일 수와 전송될 총 바이트 수를 보고합니다.
- OnDeployFileProgress: 이 콜백은 파일별로 버퍼 블록이 성공적으로 전송될 때마다 호출됩니다. 전송은 여러 스레드에서 동시에 수행되므로 코드에서 파일 이름별로 진행 상황을 추적하고 일반적인 다중 스레딩 문제로부터 보호해야 합니다. 이 콜백은 전송 시작 시 한 번, 전송 종료 시 한 번 호출되므로 길이가 0인 파일의 경우 이 콜백이 두 번 호출됩니다.
- OnDeployExtraFileDetected: PC에는 없고 콘솔에서 발견된 파일이 있음을 나타냅니다.
- OnDeployExtraFileRemoved: Deploy의 fRemoveExtraFiles 매개 변수가 TRUE로 설정된 경우, 콘솔에서 파일이 삭제될 때 이 콜백이 호출됩니다.
- OnDeployError는 현재 구현에서는 사용되지 않지만 향후 사용을 위해 예약되어 있습니다.