ÉNUMÉRATION DODownloadProperty (deliveryoptimization.h)

L’énumération DODownloadProperty spécifie l’ID des propriétés pour l’opération de téléchargement d’optimisation de la distribution. Cette énumération est utilisée par l’interface IDODownload et effectuée par une valeur VARIANT, où le type de valeur est contenu.

Syntaxe

typedef enum _DODownloadProperty {
  DODownloadProperty_Id,
  DODownloadProperty_Uri,
  DODownloadProperty_ContentId,
  DODownloadProperty_DisplayName,
  DODownloadProperty_LocalPath,
  DODownloadProperty_HttpCustomHeaders,
  DODownloadProperty_CostPolicy,
  DODownloadProperty_SecurityFlags,
  DODownloadProperty_CallbackFreqPercent,
  DODownloadProperty_CallbackFreqSeconds,
  DODownloadProperty_NoProgressTimeoutSeconds,
  DODownloadProperty_ForegroundPriority,
  DODownloadProperty_BlockingMode,
  DODownloadProperty_CallbackInterface,
  DODownloadProperty_StreamInterface,
  DODownloadProperty_SecurityContext,
  DODownloadProperty_NetworkToken,
  DODownloadProperty_CorrelationVector,
  DODownloadProperty_DecryptionInfo,
  DODownloadProperty_IntegrityCheckInfo,
  DODownloadProperty_IntegrityCheckMandatory,
  DODownloadProperty_TotalSizeBytes,
  DODownloadProperty_DisallowOnCellular,
  DODownloadProperty_HttpCustomAuthHeaders,
  DODownloadProperty_HttpAllowSecureToNonSecureRedirect,
  DODownloadProperty_NonVolatile,
  DODownloadProperty_HttpRedirectionTarget,
  DODownloadProperty_HttpResponseHeaders,
  DODownloadProperty_HttpServerIPAddress,
  DODownloadProperty_HttpStatusCode
} DODownloadProperty;

Constantes

DODownloadProperty_Id Lecture seule. Utilisez cette propriété pour obtenir l’ID qui identifie de manière unique le téléchargement. Le type VARIANT est VT_BSTR.
DODownloadProperty_Uri Utilisez cette propriété pour définir ou obtenir le chemin d’uri distant de la ressource à télécharger. Cette propriété n’est requise que si DODownloadProperty_ContentId n’est pas fourni. Le type VARIANT est VT_BSTR.
DODownloadProperty_ContentId Utilisez cette propriété pour définir ou obtenir l’ID de contenu unique de téléchargement. Cette propriété n’est requise que si DODownloadProperty_Uri n’est pas fourni. Le type VARIANT est VT_BSTR.
DODownloadProperty_DisplayName Optionnel. Utilisez cette propriété pour définir ou obtenir le nom d’affichage du téléchargement. Le type VARIANT est VT_BSTR.
DODownloadProperty_LocalPath Utilisez cette propriété pour définir ou obtenir le nom du chemin d’accès local pour enregistrer le fichier de téléchargement. Si le chemin d’accès n’existe pas, l’optimisation de la distribution tente de le créer sous les privilèges de l’appelant. Cette propriété n’est requise que si DODownloadProperty_StreamInterface n’a pas été fournie. Le type VARIANT est VT_BSTR.
DODownloadProperty_HttpCustomHeaders Optionnel. Utilisez cette propriété pour définir ou obtenir des en-têtes de requête HTTP personnalisés. L’optimisation de la distribution inclut ces en-têtes lors des opérations de requête de fichier HTTP. Les en-têtes doivent déjà être mis en forme en tant qu’en-têtes HTTP standard. Le type VARIANT est VT_BSTR.
DODownloadProperty_CostPolicy Optionnel. Utilisez cette propriété pour définir ou obtenir l’une des valeurs d’énumération DODownloadCostPolicy . Le type VARIANT est VT_UI4.
DODownloadProperty_SecurityFlags Écriture seule facultative. Utilisez cette propriété pour définir ou obtenir les indicateurs de sécurité WinHTTP standard (WINHTTP_OPTION_SECURITY_FLAGS). Le type VARIANT est VT_UI4. Les indicateurs suivants sont pris en charge : * SECURITY_FLAG_IGNORE_CERT_CN_INVALID. Autorise un nom commun non valide dans un certificat. * SECURITY_FLAG_IGNORE_CERT_DATE_INVALID. Autorise une date de certificat non valide. * SECURITY_FLAG_IGNORE_UNKNOWN_CA. Autorise une autorité de certification non valide. * SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE. Permet d’établir l’identité d’un serveur avec un certificat non-serveur. * WINHTTP_ENABLE_SSL_REVOCATION. Autorise la révocation SSL. Si cet indicateur est défini, les indicateurs ci-dessus sont ignorés.
DODownloadProperty_CallbackFreqPercent Optionnel. Utilisez cette propriété pour définir ou obtenir la fréquence de rappel en fonction du pourcentage de téléchargement. Le type VARIANT est VT_UI4.
DODownloadProperty_CallbackFreqSeconds Optionnel. Utilisez cette propriété pour définir ou obtenir la fréquence de rappel en fonction de l’heure de téléchargement. La valeur par défaut est toutes les secondes. Le type VARIANT est VT_UI4.
DODownloadProperty_NoProgressTimeoutSeconds Optionnel. Utilisez cette propriété pour définir ou obtenir la durée du téléchargement sans progression. La valeur minimale acceptée est 60 secondes d’aucune activité de téléchargement. Le type VARIANT est VT_UI4.
DODownloadProperty_ForegroundPriority Optionnel. Utilisez cette propriété pour définir ou obtenir la priorité de téléchargement actuelle. VARIANT_TRUE valeur place le téléchargement au premier plan avec une priorité plus élevée. La valeur par défaut est priorité en arrière-plan. Le type VARIANT est VT_BOOL.
DODownloadProperty_BlockingMode Optionnel. Utilisez cette propriété pour définir ou obtenir le mode de blocage de téléchargement actuel. VARIANT_TRUE valeur entraîne le blocage d’IDODownload::Start jusqu’à ce que le téléchargement soit terminé ou que l’erreur s’est produite. La valeur par défaut est le mode sans blocage. Le type VARIANT est VT_BOOL.
DODownloadProperty_CallbackInterface Optionnel. Utilisez cette propriété pour définir ou obtenir le pointeur vers l’interface IDODownloadStatusCallback utilisée pour les rappels de téléchargement. Le type VARIANT est VT_UNKNOWN.
DODownloadProperty_StreamInterface Optionnel. Utilisez cette propriété pour définir ou obtenir le pointeur vers l’interface IStream utilisée pour le type de téléchargement de flux. Le type VARIANT est VT_UNKNOWN.
DODownloadProperty_SecurityContext Écriture seule facultative. Utilisez cette propriété pour définir le contexte de certificat à utiliser pendant les opérations de requête HTTP. La valeur doit se composer d’octets sérialisés de CERT_CONTEXT. Le type VARIANT est (VT_ARRAY | VT_UI1).
DODownloadProperty_NetworkToken Écriture seule facultative. Utilisez cette propriété pour définir le jeton réseau à utiliser pendant les opérations HTTP. VARIANT_TRUE valeur entraîne la capture du jeton d’identité de l’appelant et VARIANT_FALSE efface le jeton existant. La valeur par défaut est le jeton de l’utilisateur connecté. Le type VARIANT est VT_BOOL.
DODownloadProperty_CorrelationVector Optionnel. Définit un vecteur de corrélation spécifique à des fins de télémétrie. Le type VARIANT est VT_BSTR.
DODownloadProperty_DecryptionInfo Écriture seule facultative. Définit les informations de déchiffrement sous la forme d’une chaîne JSON. Le type VARIANT est VT_BSTR.
DODownloadProperty_IntegrityCheckInfo Écriture seule facultative. Définit l’emplacement du fichier de hachage de pièce (PHF), qui est utilisé par l’optimisation de la distribution pour effectuer des vérifications d’intégrité du runtime sur le contenu téléchargé. Le type VARIANT est VT_BSTR.
DODownloadProperty_IntegrityCheckMandatory Optionnel. Définit un indicateur booléen indiquant si l’utilisation du fichier de hachage de morceau (PHF) est obligatoire. Si VARIANT_TRUE, le téléchargement est abandonné si le case activée d’intégrité échoue. Le type VARIANT est VT_BOOL.
DODownloadProperty_TotalSizeBytes Optionnel. Spécifie la taille totale du téléchargement en octets. Le type VARIANT est VT_UI8.
DODownloadProperty_DisallowOnCellular Ne téléchargez pas lorsque vous utilisez une connexion cellulaire.
DODownloadProperty_HttpCustomAuthHeaders Les en-têtes HTTPS personnalisés sont utilisés en cas de contestation.
DODownloadProperty_HttpAllowSecureToNonSecureRedirect Redirection https-vers http. La valeur par défaut est FALSE.
DODownloadProperty_NonVolatile Enregistrez les informations de téléchargement dans le Registre Windows. La valeur par défaut est FALSE pour les travaux de téléchargement d’optimisation de la distribution ; TRUE pour les travaux de style BITS.

Spécifications

Client minimal pris en charge	Windows 11 Build 22621
En-tête	deliveryoptimization.h