перечисление BITS_JOB_PROPERTY_ID (bits5_0.h)

  • Статья

Определяет константы, указывающие идентификатор свойства для задания BITS.

Это перечисление используется в BITS_JOB_PROPERTY_VALUE объединении для определения типа значения, содержащегося в объединении.

Синтаксис

typedef enum BITS_JOB_PROPERTY_ID {
  BITS_JOB_PROPERTY_ID_COST_FLAGS = 1,
  BITS_JOB_PROPERTY_NOTIFICATION_CLSID = 2,
  BITS_JOB_PROPERTY_DYNAMIC_CONTENT = 3,
  BITS_JOB_PROPERTY_HIGH_PERFORMANCE = 4,
  BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE = 5,
  BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS = 7,
  BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS = 9,
  BITS_JOB_PROPERTY_ON_DEMAND_MODE = 10
} ;

Константы

 
BITS_JOB_PROPERTY_ID_COST_FLAGS
Значение: 1
Идентификатор, используемый для управления поведением передачи по сотовой сети и (или) аналогичным сетям. Это свойство может быть изменено во время передачи — новые флаги затрат вступают в силу немедленно.

Это свойство использует поле DWORDBITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_NOTIFICATION_CLSID
Значение: 2
Идентификатор, используемый для регистрации обратного вызова COM с помощью CLSID для получения уведомлений о ходе выполнения и завершении задания BITS. CLSID должен ссылаться на класс, связанный с зарегистрированным внепроцессным COM-сервером. Ему также может быть присвоено значение GUID_NULL , чтобы очистить ранее заданный ИДЕНТИФИКАТОР CLSID уведомления.

Это свойство использует поле CLsIDBITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_DYNAMIC_CONTENT
Значение: 3
Идентификатор для пометки задания BITS как желающего скачивать содержимое, которое не поддерживает обычные http-требования для загрузки BITS: HEAD запросы, заголовок Content-Length и заголовок Content-Range. Скачивание содержимого этого типа является согласием, так как BITS не может приостанавливать и возобновлять скачивание заданий без этой поддержки. Если задание с включенным этим свойством прерывается по какой-либо причине, например из-за временной потери сетевого подключения или перезагрузки системы, BITS перезапустит загрузку с самого начала, а не возобновит ее с того момента, когда она была отключена. BITS также не может регулировать использование пропускной способности для динамических скачиваний; BITS не будет выполнять передачу без переключений ни для одного задания, для которых не назначено BG_JOB_PRIORITY_FOREGROUND , поэтому обычно этот приоритет следует устанавливать каждый раз, когда задание разрешает динамическое содержимое.

Это свойство использует поле ВключитьBITS_JOB_PROPERTY_VALUE. Это свойство поддерживается только для BG_JOB_TYPE_DOWNLOAD заданий. Он не поддерживается для скачивания, использующее FILE_RANGES. Это свойство может быть задано только до первого вызова Resume в задании.
BITS_JOB_PROPERTY_HIGH_PERFORMANCE
Значение: 4
Идентификатор для маркировки задания BITS как не требующего надежных гарантий надежности. Включение этого свойства приведет к тому, что BITS не будет сохранять сведения о ходе выполнения задания, что bits обычно делает периодически. В случае неожиданного завершения работы, например потери питания, во время передачи, это приведет к потере хода выполнения BITS.

и перезапустите задание с самого начала, а не возобновляете работу с того места, где оно было отключено, как обычно. Однако это также позволит сократить количество операций записи на диск, выполняемых BITS в течение времени существования задания, что может повысить производительность для небольших заданий.

Это свойство также приводит к загрузке BITS непосредственно в целевой файл, а не к скачиванию во временный файл и перемещению временного файла в конечное место назначения после завершения передачи. Это означает, что BITS не будет очищать частично загруженное содержимое, если задание отменено или возникает неустранимая ошибка; вызывающий объект BITS отвечает за очистку целевого файла, если он создается. Однако это также немного снизит нагрузку на диск.

Это свойство рекомендуется только для сценариев, в которых выполняется большое количество небольших заданий (менее 1 МБ) и которые не требуют надежности для потери питания или других непредвиденных событий завершения работы. Экономия производительности обычно не является значительной для небольшого количества заданий или для больших рабочих мест.

Это свойство использует поле ВключитьBITS_JOB_PROPERTY_VALUE. Это свойство поддерживается только для BG_JOB_TYPE_DOWNLOAD заданий. Это свойство можно задать только перед добавлением файлов в задание.
BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE
Значение: 5
Идентификатор для пометки максимального числа байтов задания BITS будет разрешено скачивать в общей сложности. Это свойство предназначено для использования с BITS_JOB_PROPERTY_DYNAMIC_CONTENT, где вы не сможете определить размер скачиваемого файла заранее, но хотите ограничить общий возможный размер загрузки.

Это свойство использует поле ВключитьBITS_JOB_PROPERTY_VALUE. Это свойство поддерживается только для BG_JOB_TYPE_DOWNLOAD заданий. Это свойство может быть задано только до первого вызова Resume в задании.
BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS
Значение: 7
Идентификатор для пометки задания BITS как готового включать учетные данные по умолчанию в запросы к прокси-серверам. Включение этого свойства эквивалентно установке уровня безопасности WinHTTPWINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM запросов, выполняемых BITS от имени пользователя. Пользователь BITS извлекает сохраненные учетные данные из , как и тот, от имени которого он выполняет сетевые запросы: BITS обычно использует учетные данные владельца задания, если вы явно не предоставили вспомогательный маркер сети. В этом случае BITS будет использовать учетные данные вспомогательного маркера сети.

Это свойство использует поле Целевое значение BITS_JOB_PROPERTY_VALUE. Однако поддерживается только целевой объект BG_AUTH_TARGET_PROXY .
BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS
Значение: 9
Идентификатор, используемый для управления временем уведомлений BITS JobNotification и FileRangesTransferred . Включение этого свойства позволяет пользователю получать уведомления с разной скоростью. Это свойство может быть изменено во время передачи; однако новая ставка может применяться не сразу. Значение по умолчанию — 500 миллисекунда.

Это свойство использует поле DWORDBITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_ON_DEMAND_MODE
Значение: 10
Идентификатор, используемый для управления тем, находится ли задание в режиме по запросу. Задания по запросу позволяют приложению запрашивать определенные диапазоны для скачивания файлов, а не скачивать их от начала до конца. Значение по умолчанию — FALSE; задание не выполняется по запросу. Диапазоны запрашиваются с помощью метода IBackgroundCopyFile6::RequestFileRanges .

Это свойство использует поле ВключитьBITS_JOB_PROPERTY_VALUE.

Для задания BITS_JOB_PROPERTY_ON_DEMAND_MODE требуется, чтобы передача была BG_JOB_TYPE_DOWNLOAD заданием. Задание не должно быть динамическим , а сервер должен быть HTTP или HTTPS-сервером, а требования к серверу для поддержки диапазона должны быть выполнены.

Требования

Требование Значение
Минимальная версия клиента Windows 8
Минимальная версия сервера Windows Server 2012
Верхняя часть bits5_0.h

См. также раздел