structure WINHTTP_FAILED_CONNECTION_RETRIES (winhttp.h)

Configure le comportement de nouvelle tentative automatique pour les connexions ayant échoué lorsqu’elles sont utilisées avec l’indicateur d’option WINHTTP_OPTION_FAILED_CONNECTION_RETRIES . Cette structure spécifie le nombre de nouvelles tentatives autorisées et dans quelles conditions WinHTTP doit réessayer une connexion ayant échoué.

Syntaxe

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

Members

dwMaxRetries

Type : DWORD

Nombre maximal de nouvelles tentatives autorisées en fonction des conditions de nouvelle tentative spécifiées dans dwAllowedRetryConditions.

dwAllowedRetryConditions

Type : DWORD

Masque de bits des valeurs définissant les conditions de nouvelle tentative à vérifier. Il peut s’agir d’une combinaison d’une ou plusieurs des valeurs suivantes.

Valeur Sens
WINHTTP_CONNECTION_RETRY_CONDITION_408 (0x1 ) Réessayez si WinHTTP a reçu une réponse 408 (Délai d’expiration de la demande) du serveur.
WINHTTP_CONNECTION_RETRY_CONDITION_SSL_HANDSHAKE (0x2 ) Nouvelles tentatives sur les échecs de négociation TLS/SSL.
WINHTTP_CONNECTION_RETRY_CONDITION_STALE_CONNECTION (0x4 ) Réessaye si une opération d’envoi de requête expire sur une connexion réutilisée et obsolète.

Remarques

Cette structure est utilisée avec WinHttpSetOption lors de la définition de l’option WINHTTP_OPTION_FAILED_CONNECTION_RETRIES sur un handle de session. L’option doit être définie sur le handle de session avant la création de handles de connexion ou de requête à partir de cette session.

L’exemple de code suivant montre comment définir cette option pour réessayer jusqu’à 5 fois sur les échecs de connexion obsolètes.

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

Exigences

Requirement Valeur
En-tête winhttp.h

Voir aussi

WINHTTP_OPTION_FAILED_CONNECTION_RETRIES

WinHttpSetOption

  • Last updated on