> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Interface IXtfDeployCallback > Interface IXtfDeployCallback # Interface IXtfDeployCallback Fornece um retorno de chamada que é chamado quando ocorre uma ação rastreável durante uma operação [IXtfApplicationClient::Deploy](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m). ## Sintaxe ```cpp theme={null} interface IXtfDeployCallback : public IUnknown ``` ## Métodos | Método | Descrição | | - | - | | [OnDeployChangeEvaluation](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb) | Retorno de chamada invocado ao avaliar quais arquivos precisam ser transferidos ou excluídos. | | [OnDeployError](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows) | Reservado para uso interno. | | [OnDeployExtraFileDetected](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x) | Retorno de chamada invocado quando um arquivo extra é detectado. | | [OnDeployExtraFileRemoved](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb) | Retorno de chamada invocado para relatar que um arquivo extra no console foi removido. | | [OnDeployFileProgress](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w) | Retorno de chamada invocado para relatar o progresso da implantação de um arquivo no console | | [OnDeployInitialized](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi) | Retorno de chamada invocado quando a implantação começa. | | [OnDeployMetrics](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window) | Retorno de chamada invocado quando as métricas de implantação são relatadas. | ## 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](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m)). Os métodos de retorno de chamada são invocados no momento apropriado durante o processo de implantação. 1. [OnDeployInitialized](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi): 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. 2. [OnDeployChangeEvaluation](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb): 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. 3. [OnDeployMetrics](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window): 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. 4. [OnDeployFileProgress](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w): 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. 5. [OnDeployExtraFileDetected](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x): indica que foi encontrado no console um arquivo que não está no PC. 6. [OnDeployExtraFileRemoved](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb): se o parâmetro fRemoveExtraFiles de [Deploy](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m) tiver sido definido como TRUE, esse retorno de chamada será invocado quando um arquivo for excluído do console. 7. [OnDeployError](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows) não é usado pela implementação atual, mas está reservado para uso futuro. Se você quiser indicar o progresso geral da implantação, seu código deverá relatar o número de arquivos diferentes nomeados nos retornos de chamada OnDeployFileProgress até o momento, como uma porcentagem do número total de arquivos relatado ao retorno de chamada OnDeployMetrics. ## Requisitos **Cabeçalho:** xtfapplication.h **Biblioteca:** xtfapplication.lib **Plataformas com suporte:** Windows (para ferramentas de console XBOX) ## Confira também ##### Referência [XtfApplication](/pt-BR/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n) ## Related topics - [IXtfDeployCallback::OnDeployError](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows.md) - [Méthode IXtfDeployCallback::OnDeployMetrics](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window.md) - [IXtfDeployCallback::OnDeployFileProgress](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w.md) - [Méthode IXtfDeployCallback::OnDeployInitialized](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi.md) - [IXtfDeployCallback::OnDeployChangeEvaluation](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb.md)