Inicialização e terminação do contexto de retorno de chamada

Antes de a rotina de retorno de chamada da fila padrão poder ser usada, seja especificando-a como a rotina de retorno de chamada ao confirmar uma fila de arquivos, ou chamando-a de uma rotina de retorno de chamada personalizada, ela deve ser inicializada.

A função SetupInitDefaultQueueCallback cria a estrutura de contexto usada pela rotina de retorno de chamada de fila padrão. Ele retorna um ponteiro vazio para essa estrutura. Essa estrutura é essencial para a operação da rotina de retorno de chamada padrão e deve ser passada para a rotina de retorno de chamada. Você pode fazer isso ao especificar o ponteiro void como o contexto numa chamada para SetupCommitFileQueue, ou ao especificar o ponteiro void como o parâmetro de contexto ao chamar SetupDefaultQueueCallback a partir de uma rotina personalizada de retorno de chamada. Essa estrutura de contexto não deve ser alterada ou referenciada pelo aplicativo de instalação.

A função SetupInitDefaultQueueCallbackEx também inicializa um contexto para a rotina de retorno de chamada padrão da fila, mas especifica uma segunda janela para receber uma mensagem de progresso definida pelo chamador cada vez que a fila envia uma notificação. Isso permite que você use as caixas de diálogo padrão de solicitação e erro do disco e também incorpore uma barra de progresso em uma segunda janela, por exemplo, em uma página de um assistente de instalação.

Independentemente de você ter inicializado o contexto usado pela rotina de retorno de chamada de fila padrão com SetupInitDefaultQueueCallback ou SetupInitDefaultQueueCallbackEx, depois que as operações enfileiradas tiverem concluído o processamento, chame SetupTermDefaultQueueCallback para liberar os recursos alocados na inicialização da estrutura de contexto.