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

# Interfaz IXtfDeployCallback (contenido de la interfaz)

> Interfaz IXtfDeployCallback

# Interfaz IXtfDeployCallback

Proporciona una devolución de llamada que se invoca cuando se produce una acción que se puede realizar un seguimiento durante una operación de [IXtfApplicationClient::Deploy](/es/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m).

## Sintaxis

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

## Métodos

| Método | Descripción |
| - | - |
| [OnDeployChangeEvaluation](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb) | Devolución de llamada que se invoca al evaluar qué archivos deben transferirse o eliminarse. |
| [OnDeployError](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows) | Reservado para uso interno. |
| [OnDeployExtraFileDetected](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x) | Devolución de llamada que se invoca cuando se ha detectado un archivo adicional. |
| [OnDeployExtraFileRemoved](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb) | Devolución de llamada que se invoca para notificar que se ha quitado un archivo adicional de la consola. |
| [OnDeployFileProgress](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w) | Devolución de llamada que se invoca para notificar el progreso de la implementación de un archivo en la consola |
| [OnDeployInitialized](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi) | Devolución de llamada que se invoca cuando comienza la implementación. |
| [OnDeployMetrics](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window) | Devolución de llamada que se invoca cuando se notifican métricas de implementación. |

## Comentarios

Todos los métodos de devolución de llamada funcionan de la misma manera con respecto a sus valores devueltos. Si una devolución de llamada devuelve un HResult correcto, el proceso de implementación continúa. Si una devolución de llamada devuelve cualquier HResult de error, 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.

El proceso de devolución de llamada es sencillo. Cada archivo del equipo de desarrollo que realiza la implementación se compara con su archivo correspondiente en la consola de destino.

* Si un archivo es igual en el equipo y en la consola, no se hace nada más.
* Si un archivo del equipo es más reciente que el archivo de la consola, el archivo se copia del equipo a la consola.
* Si un archivo existe en el equipo y no está en la consola, se copia en la consola.
* Si un archivo existe en la consola, pero no en el equipo, se elimina opcionalmente de la consola. (Si se elimina o no viene determinado por el valor del parámetro fRemoveExtraFiles de [Deploy](/es/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m)).

Los métodos de devolución de llamada se invocan en el momento adecuado durante el proceso de implementación.

1. [OnDeployInitialized](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi): esta devolución de llamada se invoca cuando el sistema de implementación se ha activado, y se puede usar para empezar a cronometrar la implementación o inicializar cuadros de diálogo de progreso. Cuando se ha invocado esta devolución de llamada, todos los posibles cruces de límites de interoperabilidad y DLL se han completado correctamente. Esta devolución de llamada se invoca una vez por implementación.
2. [OnDeployChangeEvaluation](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb): esta devolución de llamada se invoca cuando el sistema de implementación está evaluando qué archivos deben implementarse en la consola o eliminarse de ella. Puede usar esta devolución de llamada para actualizar un indicador de progreso.
3. [OnDeployMetrics](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window): esta devolución de llamada se invoca una vez al final del proceso de evaluación, para notificar cuántos archivos se implementarán en la consola y el número total de bytes que se van a transferir.
4. [OnDeployFileProgress](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w): esta devolución de llamada se invoca cada vez que un bloque de búfer se transfiere correctamente, por archivo. Las transferencias se realizan en varios subprocesos simultáneamente, por lo que el código debe asegurarse de que realiza el seguimiento del progreso por nombre de archivo, y protegerse frente a los problemas habituales de multithreading. Esta devolución de llamada se llama una vez al principio de una transferencia y una vez al final de la transferencia, por lo que un archivo de longitud cero provocará dos invocaciones de esta devolución de llamada.
5. [OnDeployExtraFileDetected](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x): indica que se encontró un archivo en la consola que no está en el equipo.
6. [OnDeployExtraFileRemoved](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb): si el parámetro fRemoveExtraFiles de [Deploy](/es/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m) se estableció en TRUE, esta devolución de llamada se invoca cuando se elimina un archivo de la consola.
7. [OnDeployError](/es/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows) no se usa en la implementación actual, pero está reservado para uso futuro.

Si desea indicar el progreso general de la implementación, el código debe notificar el número de archivos diferentes nombrados en las devoluciones de llamada de OnDeployFileProgress hasta el momento, como porcentaje del número total de archivos notificados a la devolución de llamada de OnDeployMetrics.

## Requisitos

**Encabezado:** xtfapplication.h

**Biblioteca:** xtfapplication.lib

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

## Consulte también

##### Referencia

[XtfApplication](/es/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [Interfaz IXtfRemoteRunCallback (contenido de la interfaz)](/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)
- [IXtfConfigSettingsCallback (Contenido de la interfaz)](/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback.md)
- [IXtfRunningProcessCallback (Contenido de la interfaz)](/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/ixtfrunningprocesscallback.md)
- [Interfaz IXtfRemoteRunClient (contenido de la interfaz)](/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)
- [IXtfConsoleControlClient (Contenido de la interfaz)](/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)