Interface IXtfDeployCallback
Fornece um retorno de chamada que é chamado quando ocorre uma ação rastreável durante uma operação IXtfApplicationClient::Deploy.Sintaxe
Métodos
Comentários
Todos os métodos de retorno de chamada funcionam da mesma forma em relação aos seus valores retornados. Se um retorno de chamada retornar um HResult de sucesso, o processo de implantação continuará. Se um retorno de chamada retornar qualquer HResult de falha, o processo de implantação será cancelado imediatamente. Os arquivos que já foram transferidos ou excluídos permanecem como estão, e os arquivos transferidos parcialmente são fechados em sua forma truncada. O processo de retorno de chamada é simples. Cada arquivo no PC de desenvolvimento que está fazendo a implantação é comparado com o arquivo correspondente no console de destino.- Se um arquivo for igual no PC e no console, nada mais é feito.
- Se um arquivo no PC for mais recente que o arquivo no console, o arquivo será copiado do PC para o console.
- Se um arquivo existir no PC e não estiver no console, ele será copiado para o console.
- Se um arquivo existir no console, mas não no PC, ele poderá, opcionalmente, ser excluído do console. (A exclusão é determinada pelo valor do parâmetro fRemoveExtraFiles de Deploy).
- OnDeployInitialized: esse retorno de chamada é invocado quando o sistema de implantação é acionado e pode ser usado para começar a cronometrar a implantação ou inicializar caixas de diálogo de progresso. Quando esse retorno de chamada é invocado, todas as possíveis travessias de limites de interoperabilidade e de DLL foram concluídas com êxito. Esse retorno de chamada é invocado uma vez por implantação.
- OnDeployChangeEvaluation: esse retorno de chamada é invocado quando o sistema de implantação está avaliando quais arquivos precisam ser implantados no console ou excluídos do console. Você pode usar esse retorno de chamada para atualizar um indicador de progresso.
- OnDeployMetrics: esse retorno de chamada é invocado uma vez no final do processo de avaliação, para relatar quantos arquivos serão implantados no console e o número total de bytes a serem transferidos.
- OnDeployFileProgress: esse retorno de chamada é invocado sempre que um bloco de buffer é transferido com êxito, por arquivo. As transferências são executadas em vários threads simultaneamente, portanto, seu código deve garantir que esteja acompanhando o progresso por nome de arquivo e se proteger contra problemas normais de multithreading. Esse retorno de chamada é chamado uma vez no início de uma transferência e uma vez no final da transferência, portanto, um arquivo de comprimento zero causará duas invocações desse retorno de chamada.
- OnDeployExtraFileDetected: indica que foi encontrado no console um arquivo que não está no PC.
- OnDeployExtraFileRemoved: se o parâmetro fRemoveExtraFiles de Deploy tiver sido definido como TRUE, esse retorno de chamada será invocado quando um arquivo for excluído do console.
- OnDeployError não é usado pela implementação atual, mas está reservado para uso futuro.