Поделиться через

Перечисление DODownloadProperty (deliveryoptimization.h)

  • Статья

Перечисление DODownloadProperty указывает идентификатор свойств для операции загрузки оптимизации доставки. Это перечисление используется интерфейсом 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
Только для чтения. Используйте это свойство, чтобы получить идентификатор, который однозначно идентифицирует скачиваемое приложение. Тип VARIANT — VT_BSTR.
DODownloadProperty_Uri
Используйте это свойство, чтобы задать или получить удаленный путь URI к ресурсу для скачивания. Это свойство является обязательным, только если DODownloadProperty_ContentId не указан. Тип VARIANT — VT_BSTR.
DODownloadProperty_ContentId
Используйте это свойство, чтобы задать или получить уникальный идентификатор содержимого для скачивания. Это свойство является обязательным только в том случае, если 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. Позволяет установить удостоверение сервера с помощью сертификата, отличного от сервера.
* WINHTTP_ENABLE_SSL_REVOCATION. Разрешает отзыв SSL. Если этот флаг установлен, указанные выше флаги будут игнорироваться.
DODownloadProperty_CallbackFreqPercent
Необязательный элемент. Используйте это свойство, чтобы задать или получить частоту обратного вызова в зависимости от процента загрузки. Тип VARIANT — VT_UI4.
DODownloadProperty_CallbackFreqSeconds
Необязательный элемент. Используйте это свойство, чтобы задать или получить частоту обратного вызова в зависимости от времени загрузки. Значение по умолчанию — каждую секунду. Тип 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 значение приведет к тому, что оптимизация доставки зафиксировать маркер идентификации вызывающего объекта, а 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) обязательным. Если VARIANT_TRUE, скачивание будет прервано в случае сбоя проверка целостности. Тип VARIANT — VT_BOOL.
DODownloadProperty_TotalSizeBytes
Необязательный элемент. Указывает общий размер загрузки в байтах. Тип VARIANT — VT_UI8.
DODownloadProperty_DisallowOnCellular
Не скачивать при использовании сотового подключения.
DODownloadProperty_HttpCustomAuthHeaders
При вызове используются пользовательские заголовки HTTPS.
DODownloadProperty_HttpAllowSecureToNonSecureRedirect
Перенаправление https-to-http. По умолчанию — FALSE.
DODownloadProperty_NonVolatile
Сохраните сведения о скачивании в реестре Windows. Значение по умолчанию — FALSE для заданий скачивания оптимизации доставки; TRUE для заданий в стиле BITS.

Требования

   
Минимальная версия клиента сборка Windows 11 22621
Верхняя часть deliveryoptimization.h