다음을 통해 공유


기본 대기열 콜백 루틴에 대한 정보

기본 큐 콜백 루틴은 SetupCommitFileQueue 보낸 알림을 일반적인 방식으로 처리합니다. 기본 루틴을 사용하면 즉시 사용할 수 있는 사용자 인터페이스를 가져와 일반적인 설정 대화 상자를 만듭니다. 사용 편의성을 위해 기본 큐 콜백 루틴을 사용하고 설치 중에 생성된 대화 상자의 일관된 모양과 동작을 보장하는 것이 좋습니다.

기본 콜백 루틴에는 내부 레코드 유지를 위한 컨텍스트 구조가 필요합니다. 또한 큐는 매개 변수 집합, Param1Param2현재 알림과 관련된 추가 정보를 전달합니다.

예를 들어 큐에서 기본 콜백 루틴에 SPFILENOTIFY_NEEDMEDIA 알림을 보내는 경우 Param1 필요한 미디어에 대한 정보가 포함된 SOURCE_MEDIA 구조를 가리키고 Param2 사용자로부터 새 경로 정보를 받을 수 있는 문자 배열을 가리킵니다.

기본 콜백 루틴은 이 정보를 사용하여 사용자에게 필요한 원본 미디어를 삽입하거나, 새 경로를 지정하거나, 현재 파일 복사를 건너뛰거나, 현재 작업을 취소하라는 메시지를 표시합니다. 기본 큐 콜백 루틴은 사용자가 수행한 작업에 따라 큐에 FILEOP_NEWPATH, FILEOP_DOIT, FILEOP_SKIP 또는 FILEOP_ABORT 반환합니다.

기본 큐 콜백 루틴이 각 큐 알림을 처리하는 방법에 대한 자세한 내용은 파일 큐 알림참조하세요.

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