> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Interface IXtfDeployCallback (conteúdo da interface)

> Interface IXtfDeployCallback

# Interface IXtfDeployCallback

Fornece um retorno de chamada que é chamado quando ocorre uma ação rastreável durante uma operação [IXtfApplicationClient::Deploy](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md).

## Sintaxe

```cpp theme={null}
interface IXtfDeployCallback : public IUnknown  
```

## Métodos

| Método | Descrição |
| - | - |
| [OnDeployChangeEvaluation](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb.md) | Retorno de chamada invocado ao avaliar quais arquivos precisam ser transferidos ou excluídos. |
| [OnDeployError](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows.md) | Reservado para uso interno. |
| [OnDeployExtraFileDetected](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x.md) | Retorno de chamada invocado quando um arquivo extra é detectado. |
| [OnDeployExtraFileRemoved](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb.md) | Retorno de chamada invocado para relatar que um arquivo extra no console foi removido. |
| [OnDeployFileProgress](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w.md) | Retorno de chamada invocado para relatar o progresso da implantação de um arquivo no console |
| [OnDeployInitialized](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi.md) | Retorno de chamada invocado quando a implantação começa. |
| [OnDeployMetrics](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window.md) | 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)).

Os métodos de retorno de chamada são invocados no momento apropriado durante o processo de implantação.

1. [OnDeployInitialized](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi.md): 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb.md): 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window.md): 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w.md): 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x.md): indica que foi encontrado no console um arquivo que não está no PC.
6. [OnDeployExtraFileRemoved](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb.md): se o parâmetro fRemoveExtraFiles de [Deploy](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md) tiver sido definido como TRUE, esse retorno de chamada será invocado quando um arquivo for excluído do console.
7. [OnDeployError](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows.md) 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n.md)


## Related topics

- [Interface IXtfFindFileCallback (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFindFileCallback/ixtffindfilecallback-xtffileio-xbox-microsoft-t.md)
- [Interface IXtfCopyFileCallback (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t.md)
- [Interface IXtfEnumerateConsolesCallback (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfEnumerateConsolesCallback/ixtfenumerateconsolescallback-xtfconsolemanager-xbox-microsoft-t.md)
- [Interface IXtfRemoteRunCallback (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)
- [Interface IXtfConsoleManagerCallback (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft-t.md)