Поделиться через


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

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

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

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

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

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

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