Inicialización y finalización del contexto de devolución de llamada

Antes de que se pueda usar la rutina de devolución de llamada de cola predeterminada, ya sea especificando como rutina de devolución de llamada al confirmar una cola de archivos o llamando a ella desde una rutina de devolución de llamada personalizada, se debe inicializar.

La función SetupInitDefaultQueueCallback compila la estructura de contexto que usa la rutina de devolución de llamada de cola predeterminada. Devuelve un puntero void a esa estructura. Esta estructura es esencial para la operación predeterminada de la rutina de devolución de llamada y debe pasarse a la rutina de devolución de llamada. Para ello, especifique el puntero void como contexto en una llamada a SetupCommitFileQueue o especificando el puntero void como parámetro de contexto al llamar a SetupDefaultQueueCallback desde una rutina de devolución de llamada personalizada. La aplicación de instalación no debe modificar ni hacer referencia a esta estructura de contexto.

La función SetupInitDefaultQueueCallbackEx también inicializa un contexto para la rutina de devolución de llamada de cola predeterminada, pero especifica una segunda ventana para recibir un mensaje de progreso especificado por el autor de la llamada cada vez que la cola envía una notificación. Esto le permite usar los cuadros de diálogo de error y avisos de disco predeterminados, así como insertar también una barra de progreso en una segunda ventana, por ejemplo, en una página de un asistente para instalación.

Independientemente de si inicializó el contexto utilizado por la rutina de devolución de llamada de cola predeterminada con SetupInitDefaultQueueCallback o SetupInitDefaultQueueCallbackEx, después de que las operaciones en cola hayan terminado de procesarse, llame a SetupTermDefaultQueueCallback para liberar los recursos asignados en la inicialización de la estructura de contexto.