Méthode ibackgroundcopyjob :: Complete, méthode
Met fin au travail et enregistre les fichiers transférés sur le client.
Syntaxe
HRESULT Complete();
Paramètres
Cette méthode n’a aucun paramètre.
Valeur de retour
Cette méthode retourne les valeurs HRESULT suivantes. La méthode peut également retourner des erreurs liées au changement du nom des copies temporaires des fichiers transférés en leurs noms donnés.
| Code de retour | Description |
|---|---|
|
Tous les fichiers ont été transférés avec succès. |
|
Pour les téléchargements, l’état du travail ne peut pas être BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED. Pour les téléchargements, l’état du travail doit être BG_JOB_STATE_TRANSFERRED. |
Remarques
Tous les fichiers ont été transférés avec succès si l’état du travail est BG_JOB_STATE_TRANSFERRED. Pour vérifier l’état de la tâche, appelez la méthode méthode ibackgroundcopyjob :: GetState . Vous pouvez également implémenter l’interface IBackgroundCopyCallback pour recevoir une notification lorsque tous les fichiers ont été transférés au client.
L’optimisation de la distribution conserve uniquement les tâches qui sont inférieures à 30 jours. Tous les travaux plus anciens seront supprimés. L’optimisation de la distribution ne prend pas en charge le stratégie de groupe paramètre jobinactivitytimeout .
Pour les travaux de téléchargement, vous pouvez appeler la méthode complète à tout moment pendant le processus de transfert. Toutefois, seuls les fichiers qui ont été transférés vers le client avant l’appel de cette méthode sont enregistrés. Par exemple, si vous appelez la méthode Complete alors que l’optimisation de la distribution traite le troisième des cinq fichiers, seuls les deux premiers fichiers sont enregistrés. Pour déterminer les fichiers qui ont été transférés, appelez la méthode IBackgroundCopyFile :: GetProgress et comparez le membre bytesTransferred au membre bytesTotal de la structure BG_FILE_PROGRESS .
Pour les travaux de chargement, vous pouvez appeler la méthode Complete uniquement lorsque l’état du travail est BG_JOB_STATE_TRANSFERRED.
Le propriétaire du fichier est l’utilisateur qui a effectué l’appel. Par exemple, si un administrateur termine la tâche de quelqu’un d’autre, l’administrateur n’est pas propriétaire du travail.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 10, les applications de bureau version 1709 [ uniquement] |
| Serveur minimal pris en charge |
Windows Serveur, version 1709 [ applications de bureau uniquement] |
| En-tête |
|
| MIDL |
|
| Bibliothèque |
|
| DLL |
|
| IID |
IID_IBackgroundCopyJob est défini en tant que 37668D37-507E-4160-9316-26306D150B12 |