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 |
|---|---|
|
Êxito |
|
Não é possível validar o arquivo até que o download seja concluído. |
|
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 |