DODownloadProperty 列挙 (deliveryoptimization.h)

DODownloadProperty 列挙は、配信の最適化のダウンロード操作のプロパティの ID を指定します。 この列挙は IDODownload インターフェイスによって使用され、値の型が含まれる VARIANT 値によって実行されます。

構文

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;

定数

DODownloadProperty_Id 読み取り専用です。 ダウンロードを一意に識別する ID を取得するには、このプロパティを使用します。 VARIANT 型がVT_BSTR。
DODownloadProperty_Uri このプロパティを使用して、ダウンロードするリソースのリモート URI パスを設定または取得します。 このプロパティは、 DODownloadProperty_ContentId が指定されていない場合にのみ必要です。 VARIANT 型がVT_BSTR。
DODownloadProperty_ContentId ダウンロード固有のコンテンツ ID を設定または取得するには、このプロパティを使用します。 このプロパティは、 DODownloadProperty_Uri が指定されていない場合にのみ必要です。 VARIANT 型がVT_BSTR。
DODownloadProperty_DisplayName 省略可能。 ダウンロード表示名を設定または取得するには、このプロパティを使用します。 VARIANT 型がVT_BSTR。
DODownloadProperty_LocalPath ダウンロード ファイルを保存するローカル パス名を設定または取得するには、このプロパティを使用します。 パスが存在しない場合、配信の最適化は呼び出し元の特権で作成しようとします。 このプロパティは、 DODownloadProperty_StreamInterface が指定されていない場合にのみ必要です。 VARIANT 型がVT_BSTR。
DODownloadProperty_HttpCustomHeaders 省略可能。 カスタム HTTP 要求ヘッダーを設定または取得するには、このプロパティを使用します。 配信の最適化には、HTTP ファイル要求操作中にこれらのヘッダーが含まれます。 ヘッダーは、標準の HTTP ヘッダーとして既に書式設定されている必要があります。 VARIANT 型がVT_BSTR。
DODownloadProperty_CostPolicy 任意。 DODownloadCostPolicy 列挙値のいずれかを設定または取得するには、このプロパティを使用します。 VARIANT 型がVT_UI4。
DODownloadProperty_SecurityFlags オプションの書き込み専用。 標準の WinHTTP セキュリティ フラグ (WINHTTP_OPTION_SECURITY_FLAGS) を設定または取得するには、このプロパティを使用します。 VARIANT 型がVT_UI4。 次のフラグがサポートされています。 * SECURITY_FLAG_IGNORE_CERT_CN_INVALID。 証明書で無効な共通名を許可します。 * SECURITY_FLAG_IGNORE_CERT_DATE_INVALID。 無効な証明書の日付を許可します。 * SECURITY_FLAG_IGNORE_UNKNOWN_CA。 無効な証明機関を許可します。 * SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE。 サーバー以外の証明書を使用してサーバーの ID を確立できるようにします。 * WINHTTP_ENABLE_SSL_REVOCATION。 SSL 失効を許可します。 このフラグが設定されている場合、上記のフラグは無視されます。
DODownloadProperty_CallbackFreqPercent 任意。 ダウンロード率に基づいてコールバックの頻度を設定または取得するには、このプロパティを使用します。 VARIANT 型がVT_UI4。
DODownloadProperty_CallbackFreqSeconds 省略可能。 ダウンロード時間に基づいてコールバックの頻度を設定または取得するには、このプロパティを使用します。 既定値は 1 秒ごとです。 VARIANT 型がVT_UI4。
DODownloadProperty_NoProgressTimeoutSeconds 省略可能。 このプロパティを使用して、ダウンロードタイムアウトの長さを設定または取得します。 許容される最小値は、ダウンロード アクティビティがない 60 秒です。 VARIANT 型がVT_UI4。
DODownloadProperty_ForegroundPriority 省略可能。 このプロパティを使用して、現在のダウンロードの優先順位を設定または取得します。 VARIANT_TRUE値を指定すると、ダウンロードの優先度が高いフォアグラウンドに移動します。 既定値はバックグラウンド優先度です。 VARIANT 型がVT_BOOL。
DODownloadProperty_BlockingMode 省略可能。 現在のダウンロード ブロック モードを設定または取得するには、このプロパティを使用します。 VARIANT_TRUE値を指定すると、ダウンロードが完了するかエラーが発生するまで IDODownload::Start がブロックされます。 既定値は非ブロッキング モードです。 VARIANT 型がVT_BOOL。
DODownloadProperty_CallbackInterface 省略可能。 このプロパティを使用して、ダウンロード コールバックに使用される IDODownloadStatusCallback インターフェイスへのポインターを設定または取得します。 VARIANT 型がVT_UNKNOWN。
DODownloadProperty_StreamInterface 省略可能。 ストリームのダウンロードの種類に使用される IStream インターフェイスへのポインターを設定または取得するには、このプロパティを使用します。 VARIANT 型がVT_UNKNOWN。
DODownloadProperty_SecurityContext オプションの書き込み専用。 HTTP 要求操作中に使用する証明書コンテキストを設定するには、このプロパティを使用します。 値は、CERT_CONTEXTのシリアル化されたバイトで構成されている必要があります。 VARIANT 型は (VT_ARRAY |VT_UI1)。
DODownloadProperty_NetworkToken オプションの書き込み専用。 HTTP 操作中に使用するネットワーク トークンを設定するには、このプロパティを使用します。 VARIANT_TRUE値を指定すると、配信の最適化によって呼び出し元の ID トークンがキャプチャされ、VARIANT_FALSEは既存のトークンをクリアします。 既定値は、ログオンしているユーザーのトークンです。 VARIANT 型がVT_BOOL。
DODownloadProperty_CorrelationVector 任意。 テレメトリの目的で特定の相関ベクトルを設定します。 VARIANT 型がVT_BSTR。
DODownloadProperty_DecryptionInfo オプションの書き込み専用。 復号化情報を JSON 文字列の形式で設定します。 VARIANT 型がVT_BSTR。
DODownloadProperty_IntegrityCheckInfo オプションの書き込み専用。 ダウンロードしたコンテンツに対してランタイム整合性チェックを実行するために配信の最適化によって使用される部分ハッシュ ファイル (PHF) の場所を設定します。 VARIANT 型がVT_BSTR。
DODownloadProperty_IntegrityCheckMandatory 任意。 部分ハッシュ ファイル (PHF) の使用が必須かどうかを示すブール型 (Boolean) のフラグを設定します。 VARIANT_TRUE場合、整合性チェックが失敗した場合、ダウンロードは中止されます。 VARIANT 型がVT_BOOL。
DODownloadProperty_TotalSizeBytes 省略可能。 合計ダウンロード サイズをバイト単位で指定します。 VARIANT 型がVT_UI8。
DODownloadProperty_DisallowOnCellular 携帯ネットワーク接続の場合はダウンロードしないでください。
DODownloadProperty_HttpCustomAuthHeaders チャレンジ時にカスタム HTTPS ヘッダーが使用されます。
DODownloadProperty_HttpAllowSecureToNonSecureRedirect Https-to-http リダイレクト。 既定値は FALSE です。
DODownloadProperty_NonVolatile ダウンロード情報を Windows レジストリに保存します。 既定では、配信の最適化のダウンロード ジョブのTRUE場合は 。BITS スタイルのジョブの場合は FALSE です。

要件

サポートされている最小のクライアント	Windows 11 ビルド 22621
Header	deliveryoptimization.h