Service de transfert intelligent en arrière-plan (BITS)

Article
03/16/2023

Vue d’ensemble de la technologie du service de transfert intelligent en arrière-plan.

Pour développer le service de transfert intelligent en arrière-plan, vous avez besoin des en-têtes suivants :

Pour obtenir des conseils de programmation pour cette technologie, consultez :

Service de transfert intelligent en arrière-plan (BITS)

Énumérations


BG_AUTH_SCHEME Définit des constantes qui spécifient le schéma d’authentification à utiliser lorsqu’un proxy ou un serveur demande l’authentification utilisateur.
BG_AUTH_TARGET Définit des constantes qui spécifient si les informations d’identification sont utilisées pour les demandes d’authentification des utilisateurs proxy ou serveur.
BG_CERT_STORE_LOCATION Définit des constantes qui spécifient l’emplacement du magasin de certificats.
BG_ERROR_CONTEXT Définit des constantes qui spécifient le contexte dans lequel l’erreur s’est produite.
BG_JOB_PRIORITY Définit des constantes qui spécifient le niveau de priorité d’un travail.
BG_JOB_PROXY_USAGE Définit des constantes qui spécifient le proxy à utiliser pour les transferts de fichiers. Vous pouvez définir différents paramètres de proxy pour chaque travail.
BG_JOB_STATE Définit des constantes qui spécifient les différents états d’un travail.
BG_JOB_TYPE Définit des constantes qui spécifient le type de travail de transfert, comme le téléchargement.
BITS_FILE_PROPERTY_ID Définit des constantes qui spécifient des valeurs d’ID correspondant aux propriétés du fichier de copie en arrière-plan.
BITS_JOB_PROPERTY_ID Définit des constantes qui spécifient l’ID de la propriété pour le travail BITS.
BITS_JOB_TRANSFER_POLICY Définit des constantes qui spécifient des valeurs d’ID correspondant aux propriétés BITS.
GROUPPROP L’énumération GROUPPROP définit les valeurs constantes pour la récupération et la définition des valeurs de propriétés de groupe.

Fonctions


AddFile Ajoute un seul fichier au travail.
AddFiles Utilisez la méthode AddFiles pour ajouter un ou plusieurs fichiers à télécharger dans le travail.
AddFileSet Ajoute plusieurs fichiers à un travail.
AddFileWithRanges Ajoute un fichier à un travail de téléchargement et spécifie les plages du fichier que vous souhaitez télécharger.
Annuler Supprime le travail de la file d’attente de transfert et supprime les fichiers temporaires associés du client (téléchargements) et du serveur (chargements).
CancelGroup Utilisez la méthode CancelGroup pour supprimer le groupe de la file d’attente. Les fichiers entièrement téléchargés avant l’appel de cette méthode sont disponibles pour le client. Vous pouvez annuler un groupe à tout moment ; Toutefois, le groupe ne peut pas être récupéré une fois qu’il est annulé.
ClearHelperToken Ignore le jeton d’assistance et ne modifie pas les indicateurs d’utilisation.
ClearPeers Supprime tous les homologues de la liste des homologues qui peuvent servir du contenu.
ClearRecords Supprime tous les enregistrements et fichiers du cache.
Cloner Crée un autre énumérateur IEnumBackgroundCopyFiles qui contient le même état d’énumération que celui actuel.
Cloner Crée un autre énumérateur IEnumBackgroundCopyJobs qui contient le même état d’énumération que celui actuel.
Cloner Crée un autre énumérateur IEnumBitsPeerCacheRecords qui contient le même état d’énumération que celui actuel.
Cloner Crée un autre énumérateur IEnumBitsPeers qui contient le même état d’énumération que le actuel.
Cloner Utilisez la méthode Clone pour créer un autre énumérateur IEnumBackgroundCopyGroups qui contient le même état d’énumération que celui actuel.
Cloner Utilisez la méthode Clone pour créer un autre énumérateur IEnumBackgroundCopyJobs1 qui contient le même état d’énumération que celui actuel.
Terminé Termine le travail et enregistre les fichiers transférés sur le client.
CreateGroup Utilisez la méthode CreateGroup pour créer un groupe et l’ajouter à la file d’attente de téléchargement.
CreateJob Crée un travail.
CreateJob Utilisez la méthode CreateJob pour ajouter un nouveau travail au groupe. Un groupe ne peut contenir qu’un seul travail.
DeleteRecord Supprime un enregistrement et un fichier du cache. Cette méthode utilise l’identificateur de l’enregistrement pour identifier l’enregistrement à supprimer.
DeleteUrl Supprime tous les enregistrements de cache et le fichier du cache pour l’URL donnée.
DisableBITSUploads Utilisez la méthode DisableBITSUploads pour désactiver le chargement BITS sur le répertoire virtuel vers lequel l’objet ADSI pointe. Cette méthode définit la propriété d’extension IIS BITSUploadEnabled.
DiscoverPeers Génère une liste d’homologues qui peuvent servir du contenu.
EnableBITSUploads Utilisez la méthode EnableBITSUploads pour activer le chargement BITS sur le répertoire virtuel vers lequel l’objet ADSI pointe. Cette méthode définit la propriété d’extension IIS BITSUploadEnabled.
EnumFiles Récupère un pointeur d’interface IEnumBackgroundCopyFiles que vous utilisez pour énumérer les fichiers dans un travail.
EnumGroups Utilisez la méthode EnumGroups pour récupérer une liste de groupes dont l’utilisateur actuel est propriétaire. Si l’utilisateur actuel dispose de privilèges d’administrateur, la méthode retourne tous les groupes dans la file d’attente.
EnumJobs Récupère un pointeur d’interface vers un objet énumérateur que vous utilisez pour énumérer les travaux dans la file d’attente de transfert. L’ordre des travaux dans l’énumérateur est arbitraire.
EnumJobs Utilisez la méthode EnumJobs pour récupérer une liste de travaux dans le groupe. La liste ne contient qu’un seul travail.
EnumPeers Obtient un pointeur d’interface IEnumBitsPeers que vous utilisez pour énumérer les homologues qui peuvent servir du contenu. L’énumération est une instantané des enregistrements dans le cache.
EnumRecords Obtient un pointeur d’interface IEnumBitsPeerCacheRecords que vous utilisez pour énumérer les enregistrements dans le cache. L’énumération est une instantané des enregistrements dans le cache.
FileRangesTransferred BITS appelle votre implémentation de la méthode FileRangesTransferred quand une ou plusieurs plages de fichiers ont été téléchargées. Les plages de fichiers sont ajoutées au travail à l’aide de la méthode IBackgroundCopyFile6::RequestFileRanges.
FileTransferred BITS appelle votre implémentation de la méthode FileTransferred lorsque BITS termine correctement le transfert d’un fichier.
get_GroupID Utilisez la méthode get_GroupID pour récupérer l’identificateur du groupe.
get_JobID Utilisez la méthode get_JobID pour récupérer l’identificateur du travail.
get_Size Utilisez la méthode get_Size pour récupérer la taille de tous les fichiers du groupe à télécharger.
GetCleanupTask Utilisez la méthode GetCleanupTask pour récupérer un pointeur d’interface vers la tâche de nettoyage associée au répertoire virtuel.
GetCleanupTaskName Utilisez la méthode GetCleanupTaskName pour récupérer le nom de la tâche de nettoyage associée au répertoire virtuel.
GetClientCertificate Récupère le certificat client à partir du travail.
GetConfigurationFlags Obtient les indicateurs de configuration qui déterminent si l’ordinateur fournit du contenu aux homologues et peut télécharger du contenu à partir d’homologues.
GetCount Récupère le nombre de fichiers de l’énumération.
GetCount Récupère le nombre de travaux dans l’énumération.
GetCount Récupère le nombre d’enregistrements de cache dans l’énumération.
GetCount Récupère le nombre d’homologues dans l’énumération.
GetCount Utilisez la méthode GetCount pour récupérer le nombre de groupes dans l’énumération.
GetCount Utilisez la méthode GetCount pour récupérer le nombre de travaux dans l’énumération.
GetCustomHeaders Récupère les en-têtes personnalisés définis par un appel antérieur à IBackgroundCopyJobHttpOptions::SetCustomHeaders (c’est-à-dire les en-têtes que BITS envoie à l’instance distante, et non les en-têtes que BITS reçoit de la part de l’instance distante).
GetDescription Récupère la description du travail.
GetDisplayName Récupère le nom complet du travail. En règle générale, vous utilisez le nom complet pour identifier le travail dans une interface utilisateur.
GetError Récupère le code d’erreur et identifie le contexte dans lequel l’erreur s’est produite.
GetError Récupère l’interface d’erreur après qu’une erreur se produit.
GetErrorContextDescription Récupère la description du contexte dans lequel l’erreur s’est produite.
GetErrorCount Récupère le nombre de fois que BITS a tenté de transférer le travail et qu’une erreur s’est produite.
GetErrorDescription Récupère le texte d’erreur associé à l’erreur.
GetErrorDescription Récupère une description pour le code d’erreur spécifié.
GetFile Récupère un pointeur d’interface vers l’objet fichier associé à l’erreur.
GetFile Utilisez la méthode GetFile pour récupérer les noms de fichiers distants et locaux du fichier donné dans le travail.
GetFileACLFlags Récupère les indicateurs qui identifient le propriétaire et les informations ACL à conserver lors du transfert d’un fichier à l’aide de SMB.
GetFileCount Utilisez la méthode GetFileCount pour récupérer le nombre de fichiers dans le travail.
GetFileModificationTime Obtient la date et l’heure de la dernière modification du fichier sur le serveur.
GetFileRanges Obtient les plages du fichier qui se trouvent dans le cache.
GetFileRanges Récupère les plages que vous souhaitez télécharger à partir du fichier distant.
GetFileSize Obtient la taille du fichier.
GetFilledFileRanges Retourne l’ensemble des plages de fichiers qui ont été téléchargées.
GetGroup Utilisez la méthode GetGroup pour récupérer un groupe à partir de la file d’attente de téléchargement.
GetHelperTokenFlags Retourne les indicateurs d’utilisation d’un jeton associé à un travail de transfert BITS.
GetHelperTokenSid Retourne le SID du jeton d’assistance s’il est défini.
GetHttpMethod Récupère une chaîne large contenant le nom de la méthode HTTP pour le transfert BITS. Par défaut, les travaux de téléchargement sont « GET », et les travaux de chargement et de chargement-réponse sont « BITS_POST ».
GetId Récupère l’identificateur utilisé pour identifier le travail dans la file d’attente.
GetId Obtient l’identificateur qui identifie de manière unique l’enregistrement dans le cache.
GetJob Récupère un travail spécifié de la file d’attente de transfert. En règle générale, votre application conserve l’identificateur de travail, de sorte que vous pouvez récupérer le travail à partir de la file d’attente.
GetJob Utilisez la méthode GetJob pour récupérer un travail à partir du groupe.
GetLastAccessTime Obtient la date et l’heure auxquelles le fichier a été consulté pour la dernière fois.
GetLocalName Récupère le nom local du fichier.
GetMaximumCacheSize Obtient la taille maximale du cache.
GetMaximumContentAge Obtient l’âge par quand les fichiers sont supprimés du cache.
GetMaximumDownloadTime Récupère le temps maximal que BITS consacrera au transfert des fichiers dans le travail.
GetMinimumRetryDelay Récupère la durée minimale d’attente du service après avoir rencontré une condition d’erreur temporaire avant d’essayer de transférer le fichier.
GetNoProgressTimeout Récupère la durée pendant laquelle le service tente de transférer le fichier après qu’une condition d’erreur temporaire se produit. En cas de progression, le minuteur est réinitialisé.
GetNotifyCmdLine Récupère le programme à exécuter lorsque le travail entre dans l’état d’erreur ou transféré.
GetNotifyFlags Récupère les indicateurs de notification d’événement pour le travail.
GetNotifyInterface Récupère le pointeur d’interface vers votre implémentation de l’interface IBackgroundCopyCallback.
Getobject Utilisez la méthode GetObject pour récupérer un pointeur vers l’interface IBITSExtensionSetup. Cette méthode effectue la même liaison que la fonction ADsGetObject ADSI.
GetOriginUrl Obtient l’URL d’origine du fichier mis en cache.
GetOwner Récupère l’identité du propriétaire du travail.
GetOwnerElevationState Obtient une valeur qui détermine si le jeton du propriétaire a été élevé au moment de la création ou de la prise en charge du travail.
GetOwnerIntegrityLevel Obtient le niveau d’intégrité du jeton du propriétaire qui a créé ou pris la propriété du travail.
GetPeerCachingFlags Récupère les indicateurs qui déterminent si les fichiers du travail peuvent être mis en cache et servis aux homologues et si BITS peut télécharger le contenu du travail à partir d’homologues.
GetPeerDownloadStats Spécifie des statistiques sur la quantité de données téléchargées à partir d’homologues et de serveurs d’origine.
GetPeerName Obtient le nom du principal du serveur qui identifie de manière unique l’homologue.
GetPriority Récupère le niveau de priorité du travail. Le niveau de priorité détermine quand le travail est traité par rapport aux autres travaux de la file d’attente de transfert.
GetProgress Récupère des informations sur la progression du transfert de fichiers.
GetProgress Récupère les informations de progression liées au travail, telles que le nombre d’octets et de fichiers transférés.
GetProgress Utilisez la méthode GetProgress pour récupérer la progression du téléchargement.
GetProgress Utilisez la méthode GetProgress pour récupérer la progression du travail.
GetProp Utilisez la méthode GetProp pour récupérer une valeur de propriété à partir du groupe.
GetProperty Obtient une propriété générique d’un transfert de fichier BITS.
GetProperty Méthode générique pour obtenir des propriétés de travail BITS.
GetProtocol Récupère le protocole utilisé pour transférer le fichier. Le nom du fichier distant identifie le protocole à utiliser pour transférer le fichier.
GetProxySettings Récupère les informations de proxy que le travail utilise pour transférer les fichiers.
GetRecord Obtient un enregistrement à partir du cache.
GetRemoteName Récupère le nom distant du fichier.
GetReplyData Récupère une copie en mémoire des données de réponse à partir de l’application serveur. Appelez cette méthode uniquement si le type du travail est BG_JOB_TYPE_UPLOAD_REPLY et que son état est BG_JOB_STATE_TRANSFERRED.
GetReplyFileName Récupère le nom du fichier qui contient les données de réponse de l’application serveur. Appelez cette méthode uniquement si le type de travail est BG_JOB_TYPE_UPLOAD_REPLY.
GetReplyProgress Récupère les informations de progression relatives au transfert des données de réponse à partir d’un travail de chargement-réponse.
GetSecurityFlags Récupère les indicateurs pour HTTP qui déterminent si la liste de révocation de certificats est vérifiée et si certaines erreurs de certificat sont ignorées, ainsi que la stratégie à utiliser lorsqu’un serveur redirige la requête HTTP.
GetState Récupère l’état du travail.
GetStatus Utilisez la méthode GetStatus pour récupérer l’état du groupe.
GetStatus Utilisez la méthode GetStatus pour récupérer l’état du travail.
GetTemporaryName Obtient le chemin d’accès complet du fichier temporaire qui contient le contenu du téléchargement.
GetTimes Récupère les horodatages liés au travail, tels que l’heure de création ou de dernière modification du travail.
Gettype Récupère le type de transfert en cours d’exécution, tel qu’un téléchargement ou un chargement de fichier.
GetValidationState Obtient l’état de validation actuel de ce fichier.
IsAuthenticated Détermine si l’homologue est authentifié.
IsAvailable Détermine si l’homologue est disponible (en ligne) pour servir du contenu.
IsDownloadedFromPeer Obtient une valeur qui détermine si une partie du fichier a été téléchargée à partir d’un homologue.
IsFileValidated Détermine si le fichier a été validé.
JobError BITS appelle votre implémentation de la méthode JobError lorsque l’état du travail devient BG_JOB_STATE_ERROR.
JobModification BITS appelle votre implémentation de la méthode JobModification lorsque le travail a été modifié.
JobTransferred BITS appelle votre implémentation de la méthode JobTransferred lorsque tous les fichiers du travail ont été transférés avec succès.
MakeCustomHeadersWriteOnly Définit les en-têtes personnalisés HTTP pour ce travail en écriture seule.
Next Récupère un nombre spécifié d’éléments dans la séquence d’énumération. S’il reste moins que le nombre d’éléments demandé dans la séquence, il récupère les éléments restants. (IEnumBackgroundCopyFiles.Next)
Next Récupère un nombre spécifié d’éléments dans la séquence d’énumération. S’il reste moins que le nombre d’éléments demandé dans la séquence, il récupère les éléments restants. (IEnumBackgroundCopyJobs.Next)
Next Récupère un nombre spécifié d’éléments dans la séquence d’énumération. S’il reste moins que le nombre d’éléments demandé dans la séquence, il récupère les éléments restants. (IEnumBitsPeerCacheRecords.Next)
Next Récupère un nombre spécifié d’éléments dans la séquence d’énumération. S’il reste moins que le nombre d’éléments demandé dans la séquence, il récupère les éléments restants. (IEnumBitsPeers.Next)
Next Utilisez la méthode Next pour récupérer le nombre spécifié d’éléments dans la séquence d’énumération. S’il reste moins que le nombre d’éléments demandé dans la séquence, il récupère les éléments restants. (IEnumBackgroundCopyGroups.Next)
Next Utilisez la méthode Next pour récupérer le nombre spécifié d’éléments dans la séquence d’énumération. S’il reste moins que le nombre d’éléments demandé dans la séquence, il récupère les éléments restants. (IEnumBackgroundCopyJobs1.Next)
OnStatus Implémentez la méthode OnStatus pour recevoir une notification lorsque le groupe est terminé ou qu’une erreur se produit.
RemoveClientCertificate Supprime le certificat client du travail.
RemoveCredentials Supprime les informations d’identification de l’utilisation. Les informations d’identification doivent correspondre à une paire cible et schéma existante que vous avez spécifiée à l’aide de la méthode IBackgroundCopyJob2::SetCredentials. Il n’existe aucune méthode pour récupérer les informations d’identification que vous avez définies.
ReplaceRemotePrefix Remplace le texte de début de tous les noms distants du travail de téléchargement par la chaîne spécifiée.
RequestFileRanges Ajoute un nouvel ensemble de plages de fichiers à hiérarchiser pour le téléchargement.
Réinitialiser Réinitialise la séquence d'énumération au début. (IEnumBackgroundCopyFiles.Reset)
Réinitialiser Réinitialise la séquence d'énumération au début. (IEnumBackgroundCopyJobs.Reset)
Réinitialiser Réinitialise la séquence d'énumération au début. (IEnumBitsPeerCacheRecords.Reset)
Réinitialiser Réinitialise la séquence d'énumération au début. (IEnumBitsPeers.Reset)
Réinitialiser Utilisez la méthode Reset pour réinitialiser la séquence d’énumération au début. (IEnumBackgroundCopyGroups.Reset)
Réinitialiser Utilisez la méthode Reset pour réinitialiser la séquence d’énumération au début. (IEnumBackgroundCopyJobs1.Reset)
Reprendre Active un nouveau travail ou redémarre un travail qui a été suspendu.
ResumeGroup Utilisez la méthode ResumeGroup pour démarrer un groupe qui a été suspendu dans la file d’attente de téléchargement.
SetClientCertificateByID Spécifie l’identificateur du certificat client à utiliser pour l’authentification du client dans une requête HTTPS (SSL).
SetClientCertificateByName Spécifie le nom du sujet du certificat client à utiliser pour l’authentification du client dans une demande HTTPS (SSL).
SetConfigurationFlags Définit les indicateurs de configuration qui déterminent si l’ordinateur peut fournir du contenu à des homologues et télécharger du contenu à partir d’homologues.
SetCredentials Spécifie les informations d’identification à utiliser pour une demande d’authentification utilisateur de proxy ou de serveur distant.
SetCustomHeaders Spécifie un ou plusieurs en-têtes HTTP personnalisés à inclure dans les requêtes HTTP.
SetDescription Fournit une description du travail.
SetDisplayName Spécifie un nom d’affichage pour le travail. En règle générale, vous utilisez le nom d’affichage pour identifier le travail dans une interface utilisateur.
SetFileACLFlags Spécifie le propriétaire et les informations ACL à conserver lors de l’utilisation de SMB pour télécharger ou charger un fichier.
SetHelperToken Définit le jeton d’assistance pour emprunter l’identité du jeton du client COM.
SetHelperTokenFlags Définit les indicateurs d’utilisation d’un jeton associé à un travail de transfert BITS.
SetHttpMethod Remplace la méthode HTTP par défaut utilisée pour un transfert BITS.
SetMaximumCacheSize Spécifie la taille maximale du cache.
SetMaximumContentAge Spécifie quand les fichiers sont supprimés du cache en fonction de l’âge.
SetMaximumDownloadTime Définit la durée maximale que BITS consacrera au transfert des fichiers dans le travail.
SetMinimumRetryDelay Définit la durée minimale d’attente de BITS après avoir rencontré une condition d’erreur temporaire avant d’essayer de transférer le fichier.
SetNoProgressTimeout Définit la durée pendant laquelle BITS tente de transférer le fichier après qu’une condition d’erreur temporaire se produit. En cas de progression, le minuteur est réinitialisé.
SetNotifyCmdLine Spécifie un programme à exécuter si le travail entre dans l’état BG_JOB_STATE_ERROR ou BG_JOB_STATE_TRANSFERRED. BITS exécute le programme dans le contexte de l’utilisateur qui a appelé cette méthode.
SetNotifyFlags Spécifie le type de notification d’événement que vous souhaitez recevoir, comme les événements transférés par le travail.
SetNotifyInterface Identifie votre implémentation de l’interface IBackgroundCopyCallback sur BITS. Utilisez l’interface IBackgroundCopyCallback pour recevoir une notification des événements liés au travail.
SetPeerCachingFlags Définit les indicateurs qui déterminent si les fichiers du travail peuvent être mis en cache et servis aux pairs, et si le travail peut télécharger le contenu des pairs.
SetPriority Spécifie le niveau de priorité de votre travail. Le niveau de priorité détermine quand votre travail est traité par rapport aux autres travaux de la file d’attente de transfert.
SetProp Utilisez la méthode SetProp pour définir la valeur de propriété d’une propriété de groupe.
setProperty Définit une propriété générique d’un transfert de fichiers BITS.
setProperty Méthode générique pour définir les propriétés du travail BITS.
SetProxySettings Spécifie le proxy à utiliser pour transférer des fichiers.
SetRemoteName Remplace le nom distant par une nouvelle URL dans un travail de téléchargement.
SetReplyFileName Spécifie le nom du fichier à contenir les données de réponse de l’application serveur. Appelez cette méthode uniquement si le type du travail est BG_JOB_TYPE_UPLOAD_REPLY.
SetSecurityFlags Définit des indicateurs pour HTTP qui déterminent si la liste de révocation des certificats est vérifiée et si certaines erreurs de certificat sont ignorées, ainsi que la stratégie à utiliser lorsqu’un serveur redirige la requête HTTP.
SetServerCertificateValidationInterface Les certificats de serveur sont envoyés lorsqu’une connexion HTTPS est ouverte. Utilisez cette méthode pour définir un rappel à appeler afin de valider ces certificats de serveur.
SetValidationState Définit l’état de validation de ce fichier.
Skip Ignore le nombre d’éléments spécifié suivant dans la séquence d’énumération. S’il reste moins d’éléments dans la séquence que le nombre d’éléments à ignorer, il passe au-delà du dernier élément de la séquence. (IEnumBackgroundCopyFiles.Skip)
Skip Ignore le nombre d’éléments spécifié suivant dans la séquence d’énumération. S’il reste moins d’éléments dans la séquence que le nombre d’éléments à ignorer, il passe au-delà du dernier élément de la séquence. (IEnumBackgroundCopyJobs.Skip)
Skip Ignore le nombre d’éléments spécifié suivant dans la séquence d’énumération. S’il reste moins d’éléments dans la séquence que le nombre d’éléments à ignorer, il passe au-delà du dernier élément de la séquence. (IEnumBitsPeerCacheRecords.Skip)
Skip Ignore le nombre d’éléments spécifié suivant dans la séquence d’énumération. S’il reste moins d’éléments dans la séquence que le nombre d’éléments à ignorer, il passe au-delà du dernier élément de la séquence. (IEnumBitsPeers.Skip)
Skip Utilisez la méthode Skip pour ignorer le nombre d’éléments spécifié suivant dans la séquence d’énumération. S’il reste moins d’éléments dans la séquence que le nombre d’éléments à ignorer, il passe au-delà du dernier élément de la séquence. (IEnumBackgroundCopyGroups.Skip)
Skip Utilisez la méthode Skip pour ignorer le nombre d’éléments spécifié suivant dans la séquence d’énumération. S’il reste moins d’éléments dans la séquence que le nombre d’éléments à ignorer, il passe au-delà du dernier élément de la séquence. (IEnumBackgroundCopyJobs1.Skip)
Suspendre Suspend un travail. Les nouveaux travaux, les travaux en erreur et les travaux qui ont fini de transférer des fichiers sont automatiquement suspendus.
SuspendGroup Utilisez la méthode SuspendGroup pour suspendre un groupe dans la file d’attente de téléchargement. Les nouveaux groupes, les groupes en erreur ou les groupes qui ont terminé le téléchargement sont automatiquement suspendus.
SwitchToForeground Utilisez la méthode SwitchToForeground pour télécharger le groupe au premier plan au lieu de l’arrière-plan.
TakeOwnership Change la propriété du travail à l’utilisateur actuel.
UpdateDownloadPosition Spécifie une position à partir de laquelle vous devez hiérarchiser le téléchargement des données manquantes.
ValidateServerCertificate Méthode de rappel que vous implémentez et qui sera appelée pour vous permettre de valider les certificats de serveur envoyés lors de l’ouverture d’une connexion HTTPS.

Interfaces


IBackgroundCopyCallback Implémentez l’interface IBackgroundCopyCallback pour recevoir une notification indiquant qu’un travail est terminé, a été modifié ou est en erreur. Les clients utilisent cette interface au lieu d’interroger la status du travail.
IBackgroundCopyCallback1 Implémentez l’interface IBackgroundCopyCallback1 pour recevoir une notification lorsque des événements se produisent.
IBackgroundCopyCallback2 Implémentez cette interface pour recevoir une notification indiquant qu’un fichier a terminé son téléchargement.
IBackgroundCopyCallback3 Les clients implémentent l’interface IBackgroundCopyCallback3 pour recevoir une notification indiquant que le téléchargement des plages d’un fichier est terminé.
IBackgroundCopyError Utilisez l’interface IBackgroundCopyError pour déterminer la cause d’une erreur et si le processus de transfert peut continuer.
IBackgroundCopyFile IBackgroundCopyFile contient des informations sur un fichier qui fait partie d’un travail. Par exemple, vous pouvez utiliser les méthodes IBackgroundCopyFile pour récupérer les noms locaux et distants du fichier et transférer les informations de progression.
IBackgroundCopyFile2 Utilisez l’interface IBackgroundCopyFile2 pour spécifier un nouveau nom distant pour le fichier et récupérer la liste des plages à télécharger.
IBackgroundCopyFile3 Utilisez cette interface pour récupérer le nom du fichier temporaire qui contient le contenu téléchargé et valider le fichier afin que les pairs puissent demander son contenu.
IBackgroundCopyFile4 Utilisez cette interface pour récupérer les statistiques de téléchargement pour les homologues et les serveurs d’origine.
IBackgroundCopyFile5 Utilisez cette interface pour obtenir ou définir les propriétés génériques des transferts de fichiers BITS.
IBackgroundCopyFile6 Utilisez cette interface pour demander des plages de fichiers pour les travaux de téléchargement à la demande.
IBackgroundCopyGroup Utilisez l’interface IBackgroundCopyGroup pour gérer un groupe. Un groupe contient des travaux de téléchargement. Par exemple, ajoutez un travail au groupe, définissez les propriétés du groupe, puis démarrez et arrêtez le groupe dans la file d’attente de téléchargement.
IBackgroundCopyJob Utilisez l’interface IBackgroundCopyJob pour ajouter des fichiers au travail, définir le niveau de priorité du travail, déterminer l’état du travail et démarrer et arrêter le travail.
IBackgroundCopyJob1 Utilisez l’interface IBackgroundCopyJob1 pour ajouter des fichiers au travail et récupérer les status du travail.
IBackgroundCopyJob2 Récupérez les données de réponse à partir d’un travail de chargement-réponse, déterminez la progression du transfert des données de réponse au client, demandez l’exécution de la ligne de commande et fournissez des informations d’identification pour les demandes d’authentification proxy et serveur distant.
IBackgroundCopyJob3 Utilisez l’interface IBackgroundCopyJob3 pour télécharger les plages d’un fichier et modifier le préfixe d’un nom de fichier distant.
IBackgroundCopyJob4 Utilisez cette interface pour activer la mise en cache des homologues, limiter le temps de téléchargement et inspecter les caractéristiques des jetons utilisateur.
IBackgroundCopyJob5 Utilisez cette interface pour interroger ou définir plusieurs comportements facultatifs d’un travail.
IBackgroundCopyJobHttpOptions Utilisez cette interface pour spécifier des certificats clients pour l’authentification client basée sur des certificats et des en-têtes personnalisés pour les requêtes HTTP.
IBackgroundCopyJobHttpOptions2 Utilisez cette interface pour récupérer et/ou remplacer la méthode HTTP utilisée pour un transfert BITS.
IBackgroundCopyJobHttpOptions3 Utilisez cette interface pour définir les en-têtes de client HTTP en écriture seule ou pour définir une méthode de rappel de validation de certificat de serveur que vous avez implémentée.
IBackgroundCopyManager Crée des travaux de transfert, récupère un objet énumérateur qui contient les travaux dans la file d’attente et récupère des travaux individuels de la file d’attente.
IBackgroundCopyQMgr Utilisez l’interface IBackgroundCopyQMgr pour créer un groupe, récupérer un groupe existant ou énumérer tous les groupes de la file d’attente. Un groupe contient un travail de téléchargement.
IBackgroundCopyServerCertificateValidationCallback Les certificats de serveur sont envoyés lorsqu’une connexion HTTPS est ouverte. Utilisez cette méthode pour implémenter un rappel à appeler pour valider ces certificats de serveur.
IBITSExtensionSetup Utilisez l’interface IBITSExtensionSetup pour activer ou désactiver les chargements BITS dans un répertoire virtuel.
IBITSExtensionSetupFactory Utilisez l’interface IBITSExtensionSetupFactory pour obtenir un pointeur vers l’interface IBITSExtensionSetup.
IBitsPeer Utilisez IBitsPeer pour obtenir des informations sur un homologue dans le quartier.
IBitsPeerCacheAdministration Utilisez IBitsPeerCacheAdministration pour gérer le pool d’homologues à partir duquel vous pouvez télécharger du contenu.
IBitsPeerCacheRecord Utilisez IBitsPeerCacheRecord pour obtenir des informations sur un fichier dans le cache.
IBitsTokenOptions Utilisez IBitsTokenOptions pour associer et gérer une paire de jetons de sécurité pour un travail de transfert BITS (Background Intelligent Transfer Service).
IEnumBackgroundCopyFiles Utilisez l’interface IEnumBackgroundCopyFiles pour énumérer les fichiers qu’un travail contient. Pour obtenir un pointeur d’interface IEnumBackgroundCopyFiles, appelez la méthode IBackgroundCopyJob::EnumFiles.
IEnumBackgroundCopyGroups Utilisez l’interface IEnumBackgroundCopyGroups pour énumérer la liste des groupes dans la file d’attente de téléchargement. Pour obtenir un pointeur d’interface IEnumBackgroundCopyGroups, appelez la méthode IBackgroundCopyQMgr::EnumGroups.
IEnumBackgroundCopyJobs Utilisez l’interface IEnumBackgroundCopyJobs pour énumérer la liste des travaux dans la file d’attente de transfert. Pour obtenir un pointeur d’interface IEnumBackgroundCopyJobs, appelez la méthode IBackgroundCopyManager::EnumJobs.
IEnumBackgroundCopyJobs1 Utilisez l’interface IEnumBackgroundCopyJobs1 pour énumérer la liste des travaux d’un groupe. Pour obtenir un pointeur d’interface IEnumBackgroundCopyJobs1, appelez la méthode IBackgroundCopyGroup::EnumJobs.
IEnumBitsPeerCacheRecords Utilisez IEnumBitsPeerCacheRecords pour énumérer les enregistrements du cache.
IEnumBitsPeers Utilisez IEnumBitsPeers pour énumérer la liste des homologues découverts par BITS.

Structures


BG_AUTH_CREDENTIALS Identifie la cible (proxy ou serveur), le schéma d’authentification et les informations d’identification de l’utilisateur à utiliser pour les demandes d’authentification de l’utilisateur. La structure est passée à la méthode IBackgroundCopyJob2::SetCredentials.
BG_AUTH_CREDENTIALS_UNION Identifie les informations d’identification à utiliser pour le schéma d’authentification spécifié dans la structure BG_AUTH_CREDENTIALS.
BG_BASIC_CREDENTIALS La structure BG_BASIC_CREDENTIALS identifie le nom d’utilisateur et le mot de passe à authentifier.
BG_FILE_INFO Fournit les noms locaux et distants du fichier à transférer.
BG_FILE_PROGRESS Fournit des informations sur la progression des fichiers, telles que le nombre d’octets transférés.
BG_FILE_RANGE Identifie une plage d’octets à télécharger à partir d’un fichier.
BG_JOB_PROGRESS Fournit des informations sur la progression du travail, telles que le nombre d’octets et de fichiers transférés.
BG_JOB_REPLY_PROGRESS Fournit des informations de progression relatives à la partie réponse d’un travail de chargement-réponse.
BG_JOB_TIMES Fournit des horodatages liés aux travaux.
BITS_FILE_PROPERTY_VALUE Fournit la valeur de propriété d’un fichier BITS.
BITS_JOB_PROPERTY_VALUE Fournit la valeur de propriété du travail BITS en fonction de la valeur de l’énumération BITS_JOB_PROPERTY_ID.
FILESETINFO La structure FILESETINFO identifie les noms distants et locaux du fichier à télécharger.

Partager via