énumération BITS_JOB_PROPERTY_ID (bits5_0.h)

  • Article

Définit des constantes qui spécifient l’ID de la propriété pour le travail BITS.

Cette énumération est utilisée dans l’union BITS_JOB_PROPERTY_VALUE pour déterminer le type de valeur contenue dans l’union.

Syntax

typedef enum BITS_JOB_PROPERTY_ID {
  BITS_JOB_PROPERTY_ID_COST_FLAGS = 1,
  BITS_JOB_PROPERTY_NOTIFICATION_CLSID = 2,
  BITS_JOB_PROPERTY_DYNAMIC_CONTENT = 3,
  BITS_JOB_PROPERTY_HIGH_PERFORMANCE = 4,
  BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE = 5,
  BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS = 7,
  BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS = 9,
  BITS_JOB_PROPERTY_ON_DEMAND_MODE = 10
} ;

Constantes

 
BITS_JOB_PROPERTY_ID_COST_FLAGS
Valeur : 1
ID utilisé pour contrôler le comportement de transfert sur des réseaux cellulaires et/ou similaires. Cette propriété peut être modifiée pendant qu’un transfert est en cours : les nouveaux indicateurs de coût prendront effet immédiatement.

Cette propriété utilise le champ DWORD du BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_NOTIFICATION_CLSID
Valeur : 2
ID utilisé pour inscrire un rappel COM par CLSID afin de recevoir des notifications sur la progression et l’achèvement d’un travail BITS. Le CLSID doit faire référence à une classe associée à un serveur COM hors processus inscrit. Il peut également être défini sur GUID_NULL pour effacer un CLSID de notification précédemment défini.

Cette propriété utilise le champ CLsID du BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_DYNAMIC_CONTENT
Valeur : 3
ID permettant de marquer un travail BITS comme étant prêt à télécharger du contenu qui ne prend pas en charge les exigences HTTP normales pour les téléchargements BITS : HEAD requêtes, l’en-tête Content-Length et l’en-tête Content-Range. Le téléchargement de ce type de contenu est une option d’adhésion, car BITS ne peut pas suspendre et reprendre les téléchargements sans cette prise en charge. Si un travail avec cette propriété activée est interrompu pour une raison quelconque, telle qu’une perte temporaire de connectivité réseau ou le redémarrage du système, BITS redémarre le téléchargement à partir du début au lieu de reprendre là où il s’est arrêté. BITS ne peut pas non plus limiter l’utilisation de la bande passante pour les téléchargements dynamiques ; BITS n’effectue pas de transferts non autorisés pour un travail qui n’a pas BG_JOB_PRIORITY_FOREGROUND affecté. Vous devez donc généralement définir cette priorité chaque fois que vous utilisez définir un travail comme autorisant le contenu dynamique.

Cette propriété utilise le champ Enable du BITS_JOB_PROPERTY_VALUE. Cette propriété est uniquement prise en charge pour les travaux BG_JOB_TYPE_DOWNLOAD . Il n’est pas pris en charge pour les téléchargements qui utilisent FILE_RANGES. Cette propriété ne peut être définie qu’avant la première fois que Resume est appelé sur un travail.
BITS_JOB_PROPERTY_HIGH_PERFORMANCE
Valeur : 4
ID permettant de marquer un travail BITS comme ne nécessitant pas de garanties de fiabilité fortes. L’activation de cette propriété permet à BITS d’éviter de conserver des informations sur la progression normale du travail, ce que BITS fait normalement régulièrement. En cas d’arrêt inattendu, tel qu’une perte de courant, lors d’un transfert, bits perd sa progression

et redémarrez le travail à partir du début au lieu de reprendre là où il s’est arrêté comme d’habitude. Toutefois, il réduit également le nombre d’écritures sur disque que bits effectue au cours de la durée de vie d’un travail, ce qui peut améliorer les performances pour les travaux plus petits.

Cette propriété entraîne également le téléchargement de BITS directement dans le fichier de destination, au lieu de télécharger vers un fichier temporaire et de déplacer le fichier temporaire vers la destination finale une fois le transfert terminé. Cela signifie que BITS ne propre aucun contenu partiellement téléchargé si un travail est annulé ou rencontre une condition d’erreur irrécupérable ; l’appelant BITS est responsable du nettoyage du fichier de destination, s’il est créé. Toutefois, cela réduit également légèrement la surcharge du disque.

Cette propriété est recommandée uniquement pour les scénarios qui impliquent un grand nombre de petits travaux (moins de 1 Mo) et qui ne nécessitent pas de fiabilité en cas de perte de courant ou d’autres événements d’arrêt inattendus. Les économies de performances ne sont généralement pas significatives pour un petit nombre d’emplois ou pour des travaux plus importants.

Cette propriété utilise le champ Enable du BITS_JOB_PROPERTY_VALUE. Cette propriété est uniquement prise en charge pour les travaux BG_JOB_TYPE_DOWNLOAD . Cette propriété ne peut être définie qu’avant l’ajout de fichiers à un travail.
BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE
Valeur : 5
ID permettant de marquer le nombre maximal d’octets qu’un travail BITS sera autorisé à télécharger au total. Cette propriété est destinée à être utilisée avec BITS_JOB_PROPERTY_DYNAMIC_CONTENT, où vous ne pourrez peut-être pas déterminer la taille du fichier à télécharger à l’avance, mais souhaitez limiter la taille totale de téléchargement possible.

Cette propriété utilise le champ Enable du BITS_JOB_PROPERTY_VALUE. Cette propriété est uniquement prise en charge pour les travaux BG_JOB_TYPE_DOWNLOAD . Cette propriété ne peut être définie qu’avant la première fois que Resume est appelé sur un travail.
BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS
Valeur : 7
ID permettant de marquer un travail BITS comme étant prêt à inclure des informations d’identification par défaut dans les demandes adressées aux serveurs proxy. L’activation de cette propriété revient à définir un niveau de sécurité WinHTTPde WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM sur les demandes effectuées par BITS au nom de l’utilisateur. L’utilisateur BITS récupère les informations d’identification stockées du est le même que celui qu’il effectue pour le compte de : BITS utilise normalement les informations d’identification du propriétaire du travail, sauf si vous avez fourni explicitement un jeton d’assistance réseau, auquel cas BITS utilisera les informations d’identification du jeton d’assistance réseau.

Cette propriété utilise le champ Cible du BITS_JOB_PROPERTY_VALUE. Toutefois, seule la cible BG_AUTH_TARGET_PROXY est prise en charge.
BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS
Valeur : 9
ID utilisé pour contrôler le minutage des notifications BITS JobNotification et FileRangesTransferred . L’activation de cette propriété permet à un utilisateur d’être averti à un taux différent. Cette propriété peut être modifiée pendant qu’un transfert est en cours ; toutefois, le nouveau taux ne peut pas être appliqué immédiatement. La valeur par défaut est 500 millisecondes.

Cette propriété utilise le champ DWORD du BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_ON_DEMAND_MODE
Valeur : 10
ID utilisé pour contrôler si un travail est en mode à la demande. Les travaux à la demande permettent à l’application de demander des plages particulières pour un téléchargement de fichier au lieu de les télécharger du début à la fin. La valeur par défaut est FALSE ; le travail n’est pas à la demande. Les plages sont demandées à l’aide de la méthode IBackgroundCopyFile6 ::RequestFileRanges .

Cette propriété utilise le champ Enable du BITS_JOB_PROPERTY_VALUE.

Les conditions requises pour un travail BITS_JOB_PROPERTY_ON_DEMAND_MODE sont que le transfert doit être un travail BG_JOB_TYPE_DOWNLOAD . Le travail ne doit pas être DYNAMIQUE et le serveur doit être un serveur HTTP ou HTTPS et les exigences de serveur pour la prise en charge des plages doivent toutes être satisfaites.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8
Serveur minimal pris en charge Windows Server 2012
En-tête bits5_0.h

Voir aussi