다음을 통해 공유

큐 약정 순서

  • 아티클

SetupCommitFileQueue 함수는 파일 큐를 커밋할 때 파일 삭제 작업, 파일 이름 바꾸기 작업, 마지막으로 파일 복사 작업 순서로 파일 작업을 처리합니다. 다음 개요는 큐 약정 프로세스의 수명 주기를 보여 줍니다.

 

  • 삭제 하위 큐 시작
    • 파일 삭제 작업 <시작 -- 각각에 대해 반복
    • 파일 삭제 작업 <완료 - 큐에 대기된 파일 삭제
  • 삭제 하위 큐 완료
  • 하위 큐 이름 바꾸기 시작
    • 파일 이름 바꾸기 작업 <시작 - 각각에 대해 반복
    • 파일 삭제 작업 <완료 - 큐에 대기된 파일 이름 바꾸기
  • 이름 바꾸기 하위 큐 완료
  • 복사 하위 쿼리 시작
    • 파일 복사 작업 <시작 - 각각에 대해 반복
    • 파일 복사 작업 <완료 - 큐에 대기된 파일 복사
    • 복사 하위 큐 완료
  • 큐 완료

 

각 단계에서 또는 오류가 발생하는 경우 SetupCommitFileQueue 함수는 콜백 루틴에 알림을 보냅니다. 콜백 루틴은 큐에서 보낸 정보를 사용하여 설치 진행률을 추적하고 필요한 경우 사용자와 상호 작용할 수 있습니다.

예를 들어 파일 복사 작업에 현재 경로에서 사용할 수 없는 원본 파일이 필요한 경우 SetupCommitFileQueue 는 필요한 파일 및 미디어에 대한 정보와 함께 콜백 루틴에 SPFILENOTIFY_NEEDMEDIA 알림을 보냅니다. 콜백 루틴은 이 정보를 사용하여 SetupPromptForDisk를 호출하여 사용자에게 다음 디스크를 삽입하라는 대화 상자를 생성할 수 있습니다.

기본 큐 콜백 루틴 인 SetupDefaultQueueCallback이 설치 API에 포함됩니다. 이 루틴은 큐 알림을 처리하고 설치에 대한 오류 대화 상자 및 진행률 표시줄을 생성합니다. 기본 큐 콜백 루틴을 그대로 사용하거나 필터 콜백 루틴을 작성하여 알림의 하위 집합을 처리하고 다른 항목을 기본 큐 콜백 루틴으로 전달할 수 있습니다.

콜백 루틴의 기능이 요구 사항에 부합하지 않는 경우 기본 큐 콜백 루틴을 호출하지 않는 자체 포함 사용자 지정 콜백 루틴을 작성할 수 있습니다.

큐 콜백 루틴에 대한 자세한 내용은 기본 큐 콜백 루틴 및 사용자 지정 큐 콜백 루틴 만들기를 참조하세요.