Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Configures automatic retry behavior for failed connections when used with the WINHTTP_OPTION_FAILED_CONNECTION_RETRIES option flag. This structure specifies how many retries are allowed and under which conditions WinHTTP should retry a failed connection.
Syntax
typedef struct _WINHTTP_FAILED_CONNECTION_RETRIES {
DWORD dwMaxRetries;
DWORD dwAllowedRetryConditions;
} WINHTTP_FAILED_CONNECTION_RETRIES, *PWINHTTP_FAILED_CONNECTION_RETRIES;
Members
dwMaxRetries
Type: DWORD
The maximum number of retries allowed based on the retry conditions specified in dwAllowedRetryConditions.
dwAllowedRetryConditions
Type: DWORD
A bitmask of values defining the retry conditions to be checked. This can be a combination of one or more of the following values.
| Value | Meaning |
|---|---|
| WINHTTP_CONNECTION_RETRY_CONDITION_408 (0x1) | Retries if WinHTTP received a 408 (Request Timeout) response from the server. |
| WINHTTP_CONNECTION_RETRY_CONDITION_SSL_HANDSHAKE (0x2) | Retries on TLS/SSL handshake failures. |
| WINHTTP_CONNECTION_RETRY_CONDITION_STALE_CONNECTION (0x4) | Retries if a request send operation times out on a reused and stale connection. |
Remarks
This structure is used with WinHttpSetOption when setting the WINHTTP_OPTION_FAILED_CONNECTION_RETRIES option on a session handle. The option must be set on the session handle before any connection or request handles are created from that session.
The following code example shows how to set this option to retry up to 5 times on stale connection failures.
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 | Value |
|---|---|
| Header | winhttp.h |