> ## 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.

# IXtfDeployCallback::OnDeployFileProgress

> IXtfDeployCallback::OnDeployFileProgress

# IXtfDeployCallback::OnDeployFileProgress

Retorno de chamada invocado para relatar o progresso da implantação de um arquivo no console.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
public:
HRESULT OnDeployFileProgress(
         LPCWSTR pszFilePath,
         ULONGLONG ullBytesTransferred,
         ULONGLONG ullFileSize
)  
```

<a id="parametersSection" />

### Parâmetros

*pszFilePath*\
Tipo: LPCWSTR

O caminho do arquivo que está sendo implantado.

*ullBytesTransferred*\
Tipo: ULONGLONG

O número de bytes transferidos até o momento.

*ullFileSize*\
Tipo: ULONGLONG

O tamanho total do arquivo que está sendo transferido, em bytes.

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

Retorna `S_OK` para continuar a implantação ou um código de erro HRESULT para cancelar a implantação.

<a id="remarksSection" />

## Comentários

Esse retorno de chamada é invocado quando o sistema de implantação transfere arquivos do PC que está fazendo a implantação para o console. Esse retorno de chamada é chamado uma vez para cada bloco de buffer transferido com êxito para um arquivo. Esse retorno de chamada é sempre invocado pelo menos duas vezes para cada arquivo transferido com êxito: uma vez no início da implantação e uma vez no final da implantação. Se um arquivo de comprimento zero for implantado, ambas as invocações relatarão que zero bytes de zero bytes foram transferidos. Para obter mais informações sobre como os arquivos são avaliados e quando os retornos de chamada são invocados durante o processo de implantação, confira [Interface IXtfDeployCallback](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t).

<Note>O processo de transferência de arquivos para implantação usa vários threads. Seu código deve garantir que correlacione as mensagens de progresso por `pszFilePath` e se proteja contra problemas típicos de multithreading.</Note>

Assim como os outros retornos de chamada de `IXtfDeployCallback`, o processo de implantação continuará se esse retorno de chamada retornar `S_OK`. Se esse retorno de chamada retornar qualquer código de erro `HRESULT`, 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. Outra implantação deve ser concluída para garantir que todos os arquivos no console estejam completos e atualizados.

## Requisitos

**Cabeçalho:** xtfapplication.h

**Biblioteca:** xtfapplication.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

## Confira também

[Interface IXtfDeployCallback](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t)\
[XtfApplication](/pt-BR/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfDeployCallback::OnDeployExtraFileDetected](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x.md)
- [IXtfDeployCallback::OnDeployExtraFileRemoved](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb.md)
- [IXtfDeployCallback::OnDeployChangeEvaluation](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb.md)
- [Método IXtfDeployCallback::OnDeployMetrics](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window.md)
- [IXtfDeployCallback::OnDeployError](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows.md)