WINHTTP_FAILED_CONNECTION_RETRIES Struktur (winhttp.h)

Konfiguriert das verhalten der automatischen Wiederholung bei fehlgeschlagenen Verbindungen, wenn sie mit dem WINHTTP_OPTION_FAILED_CONNECTION_RETRIES-Optionskennzeichnung verwendet wird. Diese Struktur gibt an, wie viele Wiederholungen zulässig sind und unter welchen Bedingungen WinHTTP eine fehlgeschlagene Verbindung wiederholen soll.

Syntax

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

Mitglieder

dwMaxRetries

Typ: DWORD-

Die maximale Anzahl von Wiederholungsversuchen, die basierend auf den in dwAllowedRetryConditions angegebenen Wiederholungsbedingungen zulässig sind.

dwAllowedRetryConditions

Typ: DWORD-

Eine Bitmaske von Werten, die die zu überprüfenden Wiederholungsbedingungen definieren. Dies kann eine Kombination aus einem oder mehreren der folgenden Werte sein.

Bemerkungen

Diese Struktur wird mit WinHttpSetOption verwendet, wenn sie die option WINHTTP_OPTION_FAILED_CONNECTION_RETRIES für ein Sitzungshandle festlegt. Die Option muss für das Sitzungshandle festgelegt werden, bevor Verbindungs- oder Anforderungshandles aus dieser Sitzung erstellt werden.

Das folgende Codebeispiel zeigt, wie Sie diese Option so festlegen, dass sie bei veralteten Verbindungsfehlern bis zu 5 Mal wiederholt wird.

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

Siehe auch

WINHTTP_OPTION_FAILED_CONNECTION_RETRIES

WinHttpSetOption