É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

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2023-08-23