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.Sintaxis
Métodos
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).
- OnDeployInitialized: 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.
- OnDeployChangeEvaluation: 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.
- OnDeployMetrics: 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.
- OnDeployFileProgress: 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.
- OnDeployExtraFileDetected: indica que se encontró un archivo en la consola que no está en el equipo.
- OnDeployExtraFileRemoved: si el parámetro fRemoveExtraFiles de Deploy se estableció en TRUE, esta devolución de llamada se invoca cuando se elimina un archivo de la consola.
- OnDeployError no se usa en la implementación actual, pero está reservado para uso futuro.