Compartilhar via

Método IBackgroundCopyJobHttpOptions2::SetHttpMethod (bits10_2.h)

  • Artigo

Substitui o método HTTP padrão usado para uma transferência de BITS.

Sintaxe

HRESULT SetHttpMethod(
  [in] LPCWSTR method
);

Parâmetros

[in] method

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres de caracteres largos terminada em nulo constante que contém o nome do método HTTP.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O BITS permite que você, como desenvolvedor, escolha um método HTTP diferente do método padrão. Isso aumenta a capacidade do BITS de interagir com servidores que não seguem os requisitos normais de BITS para servidores HTTP. Tenha o seguinte em mente quando você escolher um método HTTP diferente do padrão.

  • O BITS altera automaticamente a prioridade do trabalho para BG_JOB_PRIORITY_FOREGROUND e impede que essa prioridade seja alterada.
  • Um erro que normalmente seria retomável (como perda de conectividade) faz a transição do trabalho para um estado ERROR. Você, como desenvolvedor, pode reiniciar o trabalho chamando IBackgroundCopyJob::Resume e o trabalho será reiniciado desde o início. Consulte Ciclo de vida de um trabalho de BITS para obter mais informações sobre os estados de trabalho do BITS.
  • O BITS não permite trabalhos DYNAMIC_CONTENT nem ON_DEMAND_MODE com SetHttpMethod.
SetHttpMethod não fará nada se o nome do método que você passar corresponder ao método HTTP padrão para o tipo de transferência. Por exemplo, se você definir um método de trabalho de download como "GET" (o padrão), a prioridade do trabalho não será alterada. O método HTTP deve ser definido antes da primeira chamada para IBackgroundCopyJob::Resume que inicia o trabalho.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1809 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho bits10_2.h (inclua Bits.h)
Biblioteca Bits.lib

Confira também

IBackgroundCopyJobHttpOptions2