estrutura WINHTTP_FAILED_CONNECTION_RETRIES (winhttp.h)

Configura o comportamento de repetição automática para conexões com falha quando usado com o sinalizador de opção WINHTTP_OPTION_FAILED_CONNECTION_RETRIES . Essa estrutura especifica quantas tentativas são permitidas e sob quais condições o WinHTTP deve tentar novamente uma conexão com falha.

Sintaxe

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

Membros

dwMaxRetries

Tipo: DWORD

O número máximo de repetições permitidas com base nas condições de repetição especificadas em dwAllowedRetryConditions.

dwAllowedRetryConditions

Tipo: DWORD

Uma máscara de bits de valores que define as condições de repetição a serem verificadas. Isso pode ser uma combinação de um ou mais dos valores a seguir.

Valor Significado
WINHTTP_CONNECTION_RETRY_CONDITION_408 (0x1) Tenta novamente se WinHTTP recebeu uma resposta 408 (Tempo limite de solicitação) do servidor.
WINHTTP_CONNECTION_RETRY_CONDITION_SSL_HANDSHAKE (0x2) Tenta novamente em falhas de handshake do TLS/SSL.
WINHTTP_CONNECTION_RETRY_CONDITION_STALE_CONNECTION (0x4) Tentará novamente se uma operação de envio de solicitação atingir o tempo limite em uma conexão reutilizado e obsoleta.

Observações

Essa estrutura é usada com WinHttpSetOption ao definir a opção WINHTTP_OPTION_FAILED_CONNECTION_RETRIES em um identificador de sessão. A opção deve ser definida no identificador de sessão antes que os identificadores de conexão ou solicitação sejam criados a partir dessa sessão.

O exemplo de código a seguir mostra como definir essa opção para tentar novamente até cinco vezes em falhas de conexão obsoletas.

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));

Requirements

Requirement Valor
Cabeçalho winhttp.h

Consulte também

WINHTTP_OPTION_FAILED_CONNECTION_RETRIES

WinHttpSetOption

  • Last updated on