О подпрограмме обратного вызова очереди по умолчанию

Подпрограмма обратного вызова очереди по умолчанию обрабатывает уведомления, отправленные SetupCommitFileQueue универсальным образом. Используя подпрограмму по умолчанию, вы получите готовый пользовательский интерфейс для создания общих диалоговых окон установки. Рекомендуется использовать подпрограмму обратного вызова очереди по умолчанию, как для удобства использования, так и для обеспечения согласованного внешнего вида и поведения диалоговых окон, созданных во время установки.

Подпрограмма обратного вызова по умолчанию требует структуры контекста для хранения внутренних записей. Кроме того, очередь передает дополнительные сведения, относящиеся к текущему уведомлению в наборе параметров, Param1 и Param2.

Например, если очередь отправляет уведомление SPFILENOTIFY_NEEDMEDIA в подпрограмму обратного вызова по умолчанию, Param1 указывает на структуру SOURCE_MEDIA, содержащую сведения о необходимом носителе, и Param2 указывает на массив символов, который может получать новые сведения о пути от пользователя.

Подпрограмма обратного вызова по умолчанию использует эти сведения для запроса пользователя вставить необходимый исходный носитель, указать новый путь, пропустить копирование текущего файла или отменить текущую операцию. Подпрограмма обратного вызова очереди по умолчанию возвращает FILEOP_NEWPATH, FILEOP_DOIT, FILEOP_SKIP или FILEOP_ABORT в очередь в зависимости от того, какое действие было предприняно пользователем.

Сведения о том, как подпрограмма обратного вызова очереди по умолчанию обрабатывает каждое уведомление очереди, см. в разделе Уведомления очереди файлов.

Сведения о пользовательских подпрограммах обратного вызова очереди см. в статье Создание подпрограммы обратного вызова пользовательской очереди.