Ordem de compromisso da fila

Quando a funçãoSetupCommitFileQueueconfirma a fila de arquivos, ela processa as operações de arquivo na seguinte ordem: operações de exclusão de arquivo, operações de renomeação de arquivo e, finalmente, operações de cópia de arquivo. A estrutura de tópicos a seguir ilustra o ciclo de vida do processo de comprometimento de uma fila.

• Iniciar a subfila de exclusão
  • Iniciar uma operação de exclusão de arquivo <-- repita para cada
  • Concluir uma operação de exclusão de arquivo <-- Exclusão de arquivo em fila
• concluir a subfila de exclusão

• Iniciar a subfila Renomear
  • Iniciar uma operação de renomeação de arquivo <-- repita para cada
  • Concluir uma operação de exclusão de arquivo <-- Renomeação de arquivo em fila
• concluir a subfila de renomeação

• iniciar o subque de cópia
  • iniciar uma operação de cópia de arquivo <-- repita para cada
  • Concluir uma operação de cópia de arquivo <-- Cópia de arquivo em fila
  • Concluir a subfila de cópia
• Termine a fila

Em cada etapa, ou se ocorrer um erro, a funçãoSetupCommitFileQueue envia uma notificação para a rotina de retorno de chamada. A rotina de retorno de chamada pode usar as informações enviadas pela fila para acompanhar o progresso da instalação e, se necessário, interagir com o usuário.

Por exemplo, se uma operação de cópia de arquivo precisasse de um arquivo de origem que não estivesse disponível no caminho atual, SetupCommitFileQueue enviaria uma notificação de SPFILENOTIFY_NEEDMEDIA para a rotina de retorno de chamada, juntamente com informações sobre o arquivo e a mídia necessários. A rotina de retorno de chamada pode usar essas informações para gerar uma caixa de diálogo que solicita que o usuário insira o próximo disco chamando SetupPromptForDisk

Uma rotina de retorno de chamada de fila padrão, SetupDefaultQueueCallback, está incluída na API de Instalação. Essa rotina lida com notificações de fila e gera caixas de diálogo de erro e barras de progresso para a instalação. Você pode usar a rotina de retorno de chamada de fila padrão como ela é, ou escrever uma rotina de retorno de chamada de filtro para lidar com um subconjunto das notificações e passar as outras para a rotina de retorno de chamada de fila padrão.

Se nenhuma das funcionalidades da rotina de retorno de chamada atender às suas necessidades, você poderá escrever uma rotina de retorno de chamada personalizada independente que não chame a rotina de retorno de chamada de fila padrão.

Para obter mais informações sobre rotinas de retorno de chamada de fila, consulte Rotina de retorno de chamada de fila padrãoe Criando uma rotina de retorno de chamada de fila personalizada.