Método IBackgroundCopyFile3::SetValidationState (bits3_0.h)

Define o estado de validação desse arquivo.

Sintaxe

HRESULT SetValidationState(
  [in] BOOL state
);

Parâmetros

[in] state

Defina como TRUE se o conteúdo do arquivo for válido, caso contrário, FALSE.

Retornar valor

O método retorna os seguintes valores retornados.

Código de retorno	Descrição
S_OK	Êxito
E_PENDING	Não é possível validar o arquivo até que o download seja concluído.
BG_E_RECORD_DELETED	O registro armazenado em cache associado a esse arquivo foi excluído.

Comentários

Se você definir o estado de validação como FALSE e o arquivo tiver sido baixado do servidor de origem, o trabalho passará para o estado de erro com um código de erro de BG_E_VALIDATION_FAILED e o progresso do arquivo será definido como zero. Em seguida, você pode chamar o método IBackgroundCopyJob::Resume para baixar o arquivo novamente.

BITS 3.0: Não chame o método IBackgroundCopyJob::Resume para baixar o arquivo novamente. Em vez disso, chame o método IBackgroundCopyJob::Complete ou IBackgroundCopyJob::Cancel para limpar o trabalho atual e, em seguida, criar um novo trabalho para baixar o arquivo.

Se você definir o estado de validação como FALSE e o arquivo tiver sido baixado de um par, o BITS removerá o arquivo do cache, redefinirá o progresso do arquivo para zero e baixará o arquivo novamente do servidor de origem.

Você só pode chamar esse método depois que o BITS terminar de transferir o arquivo. Para receber uma notificação quando a transferência for concluída, implemente o método IBackgroundCopyCallback2::FileTransferred .

Chamar o método IBackgroundCopyJob::Complete valida implicitamente o arquivo.

Se você validar um arquivo no cache e chamar IBackgroundCopyJob4::SetPeerCachingFlags para desabilitar o cache (ou o cache par será desabilitado por meio de Política de Grupo), o arquivo permanecerá no cache. Se você desabilitar o cache antes de validar o arquivo, o BITS removerá o arquivo do cache.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	bits3_0.h (inclua Bits.h)
Biblioteca	Bits.lib

Confira também

IBackgroundCopyFile3

IBackgroundCopyFile3::GetValidationState

IBitsPeerCacheRecord::IsFileValidated