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
S_OK	Correcto
E_PENDING	No puede validar el archivo hasta que se complete la descarga.
BG_E_RECORD_DELETED	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

Consulte también

IBackgroundCopyFile3

IBackgroundCopyFile3::GetValidationState

IBitsPeerCacheRecord::IsFileValidated