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

Статья
01/23/2023
Чтение занимает 2 мин

Переопределяет метод 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 (по умолчанию), приоритет задания не изменится. Перед первым вызовом IBackgroundCopyJob::Resume , который запускает задание, необходимо задать метод HTTP.

Требования


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

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

IBackgroundCopyJobHttpOptions2