Método IBackgroundCopyCallback2::FileTransferred (bits3_0.h)

BITS llama a la implementación del método FileTransferred cuando BITS finaliza correctamente la transferencia de un archivo.

Sintaxis

HRESULT FileTransferred(
  [in] IBackgroundCopyJob  *pJob,
  [in] IBackgroundCopyFile *pFile
);

Parámetros

[in] pJob

Contiene información relacionada con el trabajo. No libere pJob; BITS libera la interfaz cuando este método devuelve.

[in] pFile

Contiene información relacionada con archivos. No libere pFile; BITS libera la interfaz cuando este método devuelve.

Valor devuelto

Este método debe devolver S_OK; de lo contrario, si es negativo, BITS continúa llamando a este método hasta que se devuelve S_OK . Por motivos de rendimiento, debe limitar el número de veces que se devuelve un valor distinto de S_OK a varias veces. Como alternativa a devolver un código de error, considere la posibilidad de devolver siempre S_OK y controlar el error internamente. El intervalo en el que se llama a este método es arbitrario.

Comentarios

Normalmente, no usaría esta devolución de llamada a menos que desee validar el contenido del archivo que se descargó. Validar el archivo puede ser importante para usted si está descargando contenido que podría servirse a elementos del mismo nivel.

Para obtener el nombre del archivo temporal que contiene el contenido descargado, llame al método IBackgroundCopyFile3::GetTemporaryName . Después de comprobar el contenido, llame al método IBackgroundCopyFile3::SetValidationState para indicar a BITS si el contenido del archivo es válido. Si establece el estado de validación en FALSE y el contenido procede del servidor de origen, el trabajo pasa al estado de error.

Si el contenido procede de un elemento del mismo nivel, BITS descarga el archivo desde el servidor de origen. La devolución de llamada se vuelve a llamar después de que se complete la transferencia de archivos desde el servidor de origen.

BITS 3.0: No se vuelve a llamar a la devolución de llamada una vez completada la transferencia de archivos desde el servidor de origen.

En el caso de un trabajo, las devoluciones de llamada FileTransferred se serializan. BITS no enviará una devolución de llamada para el siguiente archivo del trabajo hasta que la devolución de llamada actual se devuelva correctamente.

Las devoluciones de llamada fileTransferred se envían antes de las devoluciones de llamada JobTransferred y JobError.

La devolución de llamada FileTransferred es para trabajos de descarga o la parte de respuesta de un trabajo de carga-respuesta.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	bits3_0.h (incluir Bits.h)
Library	Bits.lib

Consulte también

IBackgroundCopyCallback

IBackgroundCopyCallback2