IBackgroundCopyFile3 ::SetValidationState, méthode (bits3_0.h)

Définit l’état de validation de ce fichier.

Syntaxe

HRESULT SetValidationState(
  [in] BOOL state
);

Paramètres

[in] state

Définissez sur TRUE si le contenu du fichier est valide ; sinon, FALSE.

Valeur retournée

La méthode retourne les valeurs de retour suivantes.

Code de retour	Description
S_OK	Succès
E_PENDING	Vous ne pouvez pas valider le fichier tant que le téléchargement n’est pas terminé.
BG_E_RECORD_DELETED	L’enregistrement mis en cache associé à ce fichier a été supprimé.

Remarques

Si vous définissez l’état de validation sur FALSE et que le fichier a été téléchargé à partir du serveur d’origine, le travail passe à l’état d’erreur avec un code d’erreur de BG_E_VALIDATION_FAILED et la progression du fichier est définie sur zéro. Vous pouvez ensuite appeler la méthode IBackgroundCopyJob ::Resume pour télécharger à nouveau le fichier.

BITS 3.0 : N’appelez pas la méthode IBackgroundCopyJob ::Resume pour télécharger à nouveau le fichier. Au lieu de cela, appelez la méthode IBackgroundCopyJob ::Complete ou IBackgroundCopyJob ::Cancel pour nettoyer le travail actuel, puis créez un travail pour télécharger le fichier.

Si vous définissez l’état de validation sur FALSE et que le fichier a été téléchargé à partir d’un homologue, BITS supprime le fichier du cache, rétablit la progression du fichier à zéro et télécharge à nouveau le fichier à partir du serveur d’origine.

Vous pouvez appeler cette méthode uniquement une fois que BITS a terminé le transfert du fichier. Pour recevoir une notification lorsque le transfert est terminé, implémentez la méthode IBackgroundCopyCallback2 ::FileTransferred .

L’appel de la méthode IBackgroundCopyJob ::Complete valide implicitement le fichier.

Si vous validez un fichier dans le cache, puis appelez IBackgroundCopyJob4 ::SetPeerCachingFlags pour désactiver la mise en cache (ou si la mise en cache d’homologue est désactivée via stratégie de groupe), le fichier reste dans le cache. Si vous désactivez la mise en cache avant de valider le fichier, BITS supprime le fichier du cache.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	bits3_0.h (include Bits.h)
Bibliothèque	Bits.lib

Voir aussi

IBackgroundCopyFile3

IBackgroundCopyFile3 ::GetValidationState

IBitsPeerCacheRecord ::IsFileValidated