Método IBackgroundCopyFile3::SetValidationState (bits3_0.h)
Establece el estado de validación de este archivo.
Sintaxis
HRESULT SetValidationState(
[in] BOOL state
);
Parámetros
[in] state
Se establece en TRUE si el contenido del archivo es válido; de lo contrario, FALSE.
Valor devuelto
El método devuelve los siguientes valores devueltos.
| Código devuelto | Descripción |
|---|---|
|
Correcto |
|
No puede validar el archivo hasta que se complete la descarga. |
|
Se ha eliminado el registro almacenado en caché asociado a este archivo. |
Comentarios
Si establece el estado de validación en FALSE y el archivo se descargó desde el servidor de origen, el trabajo pasa al estado de error con un código de error de BG_E_VALIDATION_FAILED y el progreso del archivo se establece en cero. A continuación, puede llamar al método IBackgroundCopyJob::Resume para volver a descargar el archivo.
BITS 3.0: No llame al método IBackgroundCopyJob::Resume para volver a descargar el archivo. En su lugar, llame al método IBackgroundCopyJob::Complete o IBackgroundCopyJob::Cancel para limpiar el trabajo actual y, a continuación, crear un nuevo trabajo para descargar el archivo.
Si establece el estado de validación en FALSE y el archivo se descargó de un mismo nivel, BITS quita el archivo de la memoria caché, restablece el progreso del archivo en cero y descarga el archivo de nuevo desde el servidor de origen.
Solo puede llamar a este método después de que BITS termine de transferir el archivo. Para recibir una notificación cuando se complete la transferencia, implemente el método IBackgroundCopyCallback2::FileTransferred .
Al llamar al método IBackgroundCopyJob::Complete , se valida implícitamente el archivo.
Si valida un archivo en la memoria caché y, a continuación, llama a IBackgroundCopyJob4::SetPeerCachingFlags para deshabilitar el almacenamiento en caché (o el almacenamiento en caché del mismo nivel se deshabilita a través de directiva de grupo), el archivo permanece en la memoria caché. Si deshabilita el almacenamiento en caché antes de validar el archivo, BITS quita el archivo de la memoria caché.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | bits3_0.h (incluya Bits.h) |
| Library | Bits.lib |