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

  • Artículo

Invalida el método HTTP predeterminado usado para una transferencia de BITS.

Sintaxis

HRESULT SetHttpMethod(
  [in] LPCWSTR method
);

Parámetros

[in] method

Tipo: LPCWSTR

Puntero a una cadena terminada en null constante de caracteres anchos que contienen el nombre del método HTTP.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

BITS le permite, como desarrollador, elegir un método HTTP distinto del método predeterminado. Esto aumenta la capacidad de BITS para interactuar con los servidores que no cumplen los requisitos de BITS normales para los servidores HTTP. Tenga en cuenta lo siguiente al elegir un método HTTP diferente del predeterminado.

  • BITS cambia automáticamente la prioridad del trabajo a BG_JOB_PRIORITY_FOREGROUND e impide que se cambie esa prioridad.
  • Un error que normalmente se reanudaría (por ejemplo, la pérdida de conectividad) pasa el trabajo a un estado ERROR. Como desarrollador, puede reiniciar el trabajo llamando a IBackgroundCopyJob::Resume y el trabajo se reiniciará desde el principio. Consulte Ciclo de vida de un trabajo de BITS para obtener más información sobre los estados de trabajo de BITS.
  • BITS no permite DYNAMIC_CONTENT ni ON_DEMAND_MODE trabajos con SetHttpMethod.
SetHttpMethod no hace nada si el nombre del método que se pasa coincide con el método HTTP predeterminado para el tipo de transferencia. Por ejemplo, si establece un método de trabajo de descarga en "GET" (valor predeterminado), no se cambiará la prioridad del trabajo. El método HTTP debe establecerse antes de la primera llamada a IBackgroundCopyJob::Resume que inicia el trabajo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1809 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado bits10_2.h (incluya Bits.h)
Library Bits.lib

Consulte también

IBackgroundCopyJobHttpOptions2