WINHTTP_FAILED_CONNECTION_RETRIES 구조체(winhttp.h)

WINHTTP_OPTION_FAILED_CONNECTION_RETRIES 옵션 플래그와 함께 사용할 때 실패한 연결에 대한 자동 재시도 동작을 구성합니다. 이 구조는 허용되는 재시도 횟수와 WinHTTP가 실패한 연결을 다시 시도해야 하는 조건을 지정합니다.

Syntax

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

구성원

dwMaxRetries

형식: DWORD

dwAllowedRetryConditions에 지정된 재시도 조건에 따라 허용되는 최대 재시도 횟수입니다.

dwAllowedRetryConditions

형식: DWORD

확인할 재시도 조건을 정의하는 값의 비트 마스크입니다. 다음 값 중 하나 이상의 조합일 수 있습니다.

비고

이 구조는 세션 핸들에서 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));

요구 사항

참고하십시오

WINHTTP_OPTION_FAILED_CONNECTION_RETRIES

WinHttpSetOption