Метод IBackgroundCopyJobHttpOptions2::SetHttpMethod (bits10_2.h)

  • Статья

Переопределяет метод HTTP по умолчанию, используемый для передачи BITS.

Синтаксис

HRESULT SetHttpMethod(
  [in] LPCWSTR method
);

Параметры

[in] method

Тип: LPCWSTR

Указатель на константную строку, завершающуюся null, из расширенных символов, содержащую имя метода HTTP.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

BITS позволяет разработчику выбрать метод HTTP, отличный от метода по умолчанию. Это повышает способность BITS взаимодействовать с серверами, которые не соответствуют обычным требованиям BITS для HTTP-серверов. При выборе метода HTTP, отличного от метода по умолчанию, имейте в виду следующее.

  • BITS автоматически изменяет приоритет задания на BG_JOB_PRIORITY_FOREGROUND и предотвращает изменение этого приоритета.
  • Ошибка, которая обычно возобновляется (например, потеря подключения), переводит задание в состояние ERROR. Вы, как разработчик, можете перезапустить задание, вызвав IBackgroundCopyJob::Resume, и задание будет перезапущено с самого начала. Дополнительные сведения о состоянии задания BITS см. в разделе Жизненный цикл задания BITS .
  • BITS не разрешает DYNAMIC_CONTENT и ON_DEMAND_MODE задания с помощью SetHttpMethod.
SetHttpMethod не выполняет никаких действий, если имя передаваемого метода соответствует методу HTTP по умолчанию для типа передачи. Например, если для метода задания скачивания задано значение GET (по умолчанию), приоритет задания не будет изменен. Метод HTTP должен быть задан перед первым вызовом IBackgroundCopyJob::Resume , который запускает задание.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1809 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Целевая платформа Windows
Header bits10_2.h (включая Bits.h)
Библиотека Bits.lib

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

IBackgroundCopyJobHttpOptions2