Freigeben über

DODownloadProperty-Enumeration (deliveryoptimization.h)

  • Artikel

Die DODownloadProperty-Enumeration gibt die ID der Eigenschaften für den Downloadvorgang der Übermittlungsoptimierung an. Diese Enumeration wird von der IDODownload-Schnittstelle verwendet und von einem VARIANT-Wert ausgeführt, in dem der Werttyp enthalten ist.

Syntax

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;

Konstanten

 
DODownloadProperty_Id
Schreibgeschützt. Verwenden Sie diese Eigenschaft, um die ID abzurufen, die den Download eindeutig identifiziert. Variant-Typ ist VT_BSTR.
DODownloadProperty_Uri
Verwenden Sie diese Eigenschaft, um den Remote-URI-Pfad der herunterzuladenden Ressource festzulegen oder abzurufen. Diese Eigenschaft ist nur erforderlich, wenn DODownloadProperty_ContentId nicht bereitgestellt wird. Variant-Typ ist VT_BSTR.
DODownloadProperty_ContentId
Verwenden Sie diese Eigenschaft, um die eindeutige Inhalts-ID des Downloads festzulegen oder abzurufen. Diese Eigenschaft ist nur erforderlich, wenn DODownloadProperty_Uri nicht bereitgestellt wird. Variant-Typ ist VT_BSTR.
DODownloadProperty_DisplayName
Optional. Verwenden Sie diese Eigenschaft, um den Anzeigenamen des Downloads festzulegen oder abzurufen. Variant-Typ ist VT_BSTR.
DODownloadProperty_LocalPath
Verwenden Sie diese Eigenschaft, um den Namen des lokalen Pfads festzulegen oder abzurufen, um die Downloaddatei zu speichern. Wenn der Pfad nicht vorhanden ist, versucht die Übermittlungsoptimierung, ihn unter den Berechtigungen des Aufrufers zu erstellen. Diese Eigenschaft ist nur erforderlich, wenn DODownloadProperty_StreamInterface nicht bereitgestellt wurde. Variant-Typ ist VT_BSTR.
DODownloadProperty_HttpCustomHeaders
Optional. Verwenden Sie diese Eigenschaft, um benutzerdefinierte HTTP-Anforderungsheader festzulegen oder abzurufen. Die Übermittlungsoptimierung schließt diese Header während HTTP-Dateianforderungsvorgängen ein. Die Header müssen bereits als HTTP-Standardheader formatiert sein. Variant-Typ ist VT_BSTR.
DODownloadProperty_CostPolicy
Optional. Verwenden Sie diese Eigenschaft, um einen der DODownloadCostPolicy-Enumerationswerte festzulegen oder abzurufen. Variant-Typ ist VT_UI4.
DODownloadProperty_SecurityFlags
Optionaler Schreibschutz. Verwenden Sie diese Eigenschaft, um die standardmäßigen WinHTTP-Sicherheitsflags (WINHTTP_OPTION_SECURITY_FLAGS) festzulegen oder abzurufen. Variant-Typ ist VT_UI4.

Die folgenden Flags werden unterstützt:

* SECURITY_FLAG_IGNORE_CERT_CN_INVALID. Ermöglicht einen ungültigen allgemeinen Namen in einem Zertifikat.
* SECURITY_FLAG_IGNORE_CERT_DATE_INVALID. Lässt ein ungültiges Zertifikatdatum zu.
* SECURITY_FLAG_IGNORE_UNKNOWN_CA. Lässt eine ungültige Zertifizierungsstelle zu.
* SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE. Ermöglicht die Einrichtung der Identität eines Servers mit einem Nicht-Serverzertifikat.
* WINHTTP_ENABLE_SSL_REVOCATION. Ermöglicht die SSL-Sperrung. Wenn dieses Flag festgelegt ist, werden die obigen Flags ignoriert.
DODownloadProperty_CallbackFreqPercent
Optional. Verwenden Sie diese Eigenschaft, um die Rückrufhäufigkeit basierend auf dem Downloadprozentsatz festzulegen oder abzurufen. Variant-Typ ist VT_UI4.
DODownloadProperty_CallbackFreqSeconds
Optional. Verwenden Sie diese Eigenschaft, um die Rückrufhäufigkeit basierend auf der Downloadzeit festzulegen oder abzurufen. Der Standardwert ist jede Sekunde. Variant-Typ ist VT_UI4.
DODownloadProperty_NoProgressTimeoutSeconds
Optional. Verwenden Sie diese Eigenschaft, um die Downloadtimeoutlänge für keinen Fortschritt festzulegen oder abzurufen. Der mindest akzeptierte Wert beträgt 60 Sekunden ohne Downloadaktivität. Variant-Typ ist VT_UI4.
DODownloadProperty_ForegroundPriority
Optional. Verwenden Sie diese Eigenschaft, um die aktuelle Downloadpriorität festzulegen oder abzurufen. VARIANT_TRUE Wert bringt den Download mit höherer Priorität in den Vordergrund. Die Standardpriorität ist Hintergrundpriorität. Variant-Typ ist VT_BOOL.
DODownloadProperty_BlockingMode
Optional. Verwenden Sie diese Eigenschaft, um den aktuellen Downloadblockierungsmodus festzulegen oder abzurufen. VARIANT_TRUE Wert bewirkt , dass IDODownload::Start blockiert wird, bis der Download abgeschlossen ist oder ein Fehler aufgetreten ist. Der Standardwert ist der Nichtblockierungsmodus. Variant-Typ ist VT_BOOL.
DODownloadProperty_CallbackInterface
Optional. Verwenden Sie diese Eigenschaft, um den Zeiger auf die IDODownloadStatusCallback-Schnittstelle festzulegen oder abzurufen, die für Downloadrückrufe verwendet wird. Variant-Typ ist VT_UNKNOWN.
DODownloadProperty_StreamInterface
Optional. Verwenden Sie diese Eigenschaft, um den Zeiger auf die IStream-Schnittstelle festzulegen oder abzurufen, die für den Streamdownloadtyp verwendet wird. Variant-Typ ist VT_UNKNOWN.
DODownloadProperty_SecurityContext
Optionaler Schreibschutz. Verwenden Sie diese Eigenschaft, um den Zertifikatkontext festzulegen, der bei HTTP-Anforderungsvorgängen verwendet werden soll. Der Wert muss aus serialisierten Bytes von CERT_CONTEXT bestehen. Variant-Typ ist (VT_ARRAY | VT_UI1).
DODownloadProperty_NetworkToken
Optionaler Schreibschutz. Verwenden Sie diese Eigenschaft, um das Netzwerktoken festzulegen, das bei HTTP-Vorgängen verwendet werden soll. VARIANT_TRUE Wert bewirkt, dass die Übermittlungsoptimierung das Identitätstoken des Aufrufers erfasst, und VARIANT_FALSE das vorhandene Token löscht. Der Standardwert ist das Token des angemeldeten Benutzers. Variant-Typ ist VT_BOOL.
DODownloadProperty_CorrelationVector
Optional. Legt einen bestimmten Korrelationsvektor für Telemetriezwecke fest. Variant-Typ ist VT_BSTR.
DODownloadProperty_DecryptionInfo
Optionaler Schreibschutz. Legt Entschlüsselungsinformationen in Form einer JSON-Zeichenfolge fest. Variant-Typ ist VT_BSTR.
DODownloadProperty_IntegrityCheckInfo
Optionaler Schreibschutz. Legt den Speicherort der Stückhashdatei (PHF) fest, der von der Übermittlungsoptimierung verwendet wird, um Laufzeitintegritätsprüfungen für den heruntergeladenen Inhalt durchzuführen. Variant-Typ ist VT_BSTR.
DODownloadProperty_IntegrityCheckMandatory
Optional. Legt ein boolesches Flag fest, das angibt, ob die Verwendung der Stückhashdatei (PHF) obligatorisch ist. Wenn VARIANT_TRUE, wird der Download abgebrochen, wenn die Integritätsprüfung fehlschlägt. Variant-Typ ist VT_BOOL.
DODownloadProperty_TotalSizeBytes
Optional. Gibt die Gesamtgröße des Downloads in Bytes an. Der VARIANT-Typ ist VT_UI8.
DODownloadProperty_DisallowOnCellular
Laden Sie nicht herunter, wenn sie über eine Mobilfunkverbindung verfügen.
DODownloadProperty_HttpCustomAuthHeaders
Benutzerdefinierte HTTPS-Header werden verwendet, wenn sie herausgefordet werden.
DODownloadProperty_HttpAllowSecureToNonSecureRedirect
Https-zu-http-Umleitung. Der Standardwert ist FALSE.
DODownloadProperty_NonVolatile
Speichern Sie Downloadinformationen in der Windows-Registrierung. Der Standardwert ist FALSE für Downloadaufträge zur Übermittlungsoptimierung; TRUE für Aufträge im BITS-Stil.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 11 Build 22621
Kopfzeile deliveryoptimization.h