estructura WINHTTP_FAILED_CONNECTION_RETRIES (winhttp.h)

Configura el comportamiento de reintento automático para las conexiones con errores cuando se usa con la marca de opción WINHTTP_OPTION_FAILED_CONNECTION_RETRIES . Esta estructura especifica cuántos reintentos se permiten y en qué condiciones WinHTTP debe reintentar una conexión con error.

Sintaxis

typedef struct _WINHTTP_FAILED_CONNECTION_RETRIES {
  DWORD dwMaxRetries;
  DWORD dwAllowedRetryConditions;
} WINHTTP_FAILED_CONNECTION_RETRIES, *PWINHTTP_FAILED_CONNECTION_RETRIES;

Members

dwMaxRetries

Tipo: DWORD de

Número máximo de reintentos permitidos en función de las condiciones de reintento especificadas en dwAllowedRetryConditions.

dwAllowedRetryConditions

Tipo: DWORD de

Máscara de bits de valores que definen las condiciones de reintento que se van a comprobar. Puede ser una combinación de uno o varios de los siguientes valores.

Value Meaning
WINHTTP_CONNECTION_RETRY_CONDITION_408 (0x1) Reintenta si WinHTTP recibió una respuesta 408 (tiempo de espera de solicitud) del servidor.
WINHTTP_CONNECTION_RETRY_CONDITION_SSL_HANDSHAKE (0x2) Reintenta los errores de protocolo de enlace TLS/SSL.
WINHTTP_CONNECTION_RETRY_CONDITION_STALE_CONNECTION (0x4) Reintenta si una operación de envío de solicitud agota el tiempo de espera en una conexión reutilizada y obsoleta.

Observaciones

Esta estructura se usa con WinHttpSetOption al establecer la opción WINHTTP_OPTION_FAILED_CONNECTION_RETRIES en un identificador de sesión. La opción debe establecerse en el identificador de sesión antes de que se creen los identificadores de conexión o solicitud a partir de esa sesión.

En el ejemplo de código siguiente se muestra cómo establecer esta opción para reintentar hasta 5 veces en errores de conexión obsoletos.

WINHTTP_FAILED_CONNECTION_RETRIES FailedConnectRetries;
FailedConnectRetries.dwMaxRetries = 5;
FailedConnectRetries.dwAllowedRetryConditions = WINHTTP_CONNECTION_RETRY_CONDITION_STALE_CONNECTION;

WinHttpSetOption(hSession,
                 WINHTTP_OPTION_FAILED_CONNECTION_RETRIES,
                 &FailedConnectRetries,
                 sizeof(FailedConnectRetries));

Requisitos

Requirement Value
Encabezado winhttp.h

Consulte también

WINHTTP_OPTION_FAILED_CONNECTION_RETRIES

WinHttpSetOption

  • Last updated on