Инициализация и завершение контекста обратного вызова

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

Функция SetupInitDefaultQueueCallback создает структуру контекста, используемую подпрограммой обратного вызова очереди по умолчанию. Он возвращает пустой указатель на структуру. Эта структура необходима для операции подпрограммы обратного вызова по умолчанию и должна передаваться в подпрограмму обратного вызова. Это можно сделать, указав указатель void в качестве контекста при вызове SetupCommitFileQueue или указав указатель void в качестве параметра контекста при вызове SetupDefaultQueueCallback из настраиваемой процедуры обратного вызова. Приложение установки не должно изменять эту структуру контекста или ссылаться на нее.

Функция SetupInitDefaultQueueCallbackEx также инициализирует контекст для подпрограммы обратного вызова очереди по умолчанию, но она задает второе окно для получения сообщения о ходе выполнения, указанного вызывающей стороны, каждый раз, когда очередь отправляет уведомление. Это позволяет использовать диалоговые окна с запросами и ошибками на диске по умолчанию, а также внедрить индикатор выполнения во второе окно, например на странице мастера установки.

Независимо от того, инициализировали ли контекст, используемый подпрограммой обратного вызова очереди по умолчанию, с помощью SetupInitDefaultQueueCallbackback или SetupInitDefaultQueueCallbackEx, после завершения обработки операций в очереди вызовите Метод SetupTermDefaultQueueCallback , чтобы освободить ресурсы, выделенные при инициализации структуры контекста.