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 |
---|---|
|
Succès |
|
Vous ne pouvez pas valider le fichier tant que le téléchargement n’est pas terminé. |
|
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 |