WINHTTP_OPTION_FAILED_CONNECTION_RETRIES オプション フラグと共に使用した場合の、失敗した接続の自動再試行動作を構成します。 この構造体は、許可される再試行回数と、失敗した接続を WinHTTP が再試行する必要がある条件を指定します。
構文
typedef struct _WINHTTP_FAILED_CONNECTION_RETRIES {
DWORD dwMaxRetries;
DWORD dwAllowedRetryConditions;
} WINHTTP_FAILED_CONNECTION_RETRIES, *PWINHTTP_FAILED_CONNECTION_RETRIES;
Members
dwMaxRetries
型: DWORD
dwAllowedRetryConditions で指定された再試行条件に基づいて許可される再試行の最大数。
dwAllowedRetryConditions
型: DWORD
チェックする再試行条件を定義する値のビットマスク。 これは、次の値の 1 つ以上の組み合わせにすることができます。
| 価値 | 説明 |
|---|---|
| WINHTTP_CONNECTION_RETRY_CONDITION_408 (0x1) | WinHTTP がサーバーから 408 (要求タイムアウト) 応答を受信した場合に再試行します。 |
| WINHTTP_CONNECTION_RETRY_CONDITION_SSL_HANDSHAKE (0x2) | TLS/SSL ハンドシェイクエラーの再試行。 |
| WINHTTP_CONNECTION_RETRY_CONDITION_STALE_CONNECTION (0x4) | 再利用された古い接続で要求送信操作がタイムアウトした場合に再試行します。 |
注釈
この構造体は、セッション ハンドルで WINHTTP_OPTION_FAILED_CONNECTION_RETRIES オプションを設定するときに WinHttpSetOption と共に使用されます。 接続ハンドルまたは要求ハンドルがそのセッションから作成される前に、セッション ハンドルにオプションを設定する必要があります。
次のコード例は、古い接続エラーで最大 5 回再試行するようにこのオプションを設定する方法を示しています。
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 | 価値 |
|---|---|
| ヘッダー | winhttp.h |