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

Devolución de llamada que se invoca para notificar el progreso de la implementación de un archivo en la consola.

<a id="syntaxSection" />

## Sintaxis

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

<a id="parametersSection" />

### Parámetros

*pszFilePath*\
Tipo: LPCWSTR

Ruta de acceso del archivo que se está implementando.

*ullBytesTransferred*\
Tipo: ULONGLONG

Número de bytes transferidos hasta el momento.

*ullFileSize*\
Tipo: ULONGLONG

Tamaño total del archivo que se está transfiriendo, en bytes.

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` para continuar con la implementación, o un código de error HRESULT para cancelar la implementación.

<a id="remarksSection" />

## Comentarios

Esta devolución de llamada se invoca cuando el sistema de implementación transfiere archivos desde el equipo que realiza la implementación a la consola. Esta devolución de llamada se llama una vez por cada bloque de búfer que se transfiere correctamente para un archivo. Esta devolución de llamada siempre se invoca al menos dos veces por cada archivo transferido correctamente: una vez al principio de la implementación y otra al final de la implementación. Si se implementa un archivo de longitud cero, ambas invocaciones notifican que se han transferido cero bytes de cero bytes. Para obtener más información sobre cómo se evalúan los archivos y cuándo se invocan las devoluciones de llamada durante el proceso de implementación, consulte [Interfaz IXtfDeployCallback](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t).

<Note>El proceso de transferencia de archivos para la implementación usa varios subprocesos. El código debe asegurarse de que correlaciona los mensajes de progreso mediante `pszFilePath` y de que se protege frente a los problemas habituales de multithreading.</Note>

Al igual que con las demás devoluciones de llamada de `IXtfDeployCallback`, el proceso de implementación continúa si esta devolución de llamada devuelve `S_OK`. Si esta devolución de llamada devuelve cualquier código de error `HRESULT`, el proceso de implementación se cancela inmediatamente. Los archivos que ya se han transferido o eliminado permanecen tal como están, y los archivos transferidos parcialmente se cierran en su forma truncada. Debe completarse otra implementación para garantizar que todos los archivos de la consola estén completos y actualizados.

## Requisitos

**Encabezado:** xtfapplication.h

**Biblioteca:** xtfapplication.lib

**Plataformas compatibles:** Windows (para las herramientas de consola XBOX)

## Consulte también

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


## Related topics

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