Inicializando e encerrando o contexto de retorno de chamada

Antes que a rotina de retorno de chamada de fila padrão possa ser usada, 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 nulo 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 especificando o ponteiro void como o contexto em uma chamada para SetupCommitFileQueue ou especificando o ponteiro void como o parâmetro de contexto ao chamar SetupDefaultQueueCallback de uma rotina de retorno de chamada personalizada. 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 de fila padrão, mas especifica uma segunda janela para receber uma mensagem de progresso especificada pelo chamador sempre que a fila envia uma notificação. Isso permite que você use as caixas de diálogo de solicitação e erro de disco padrão e também insira 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 terminado o processamento, chame SetupTermDefaultQueueCallback para liberar os recursos alocados na inicialização da estrutura de contexto.