Skip to main content

XblContextSettingsSetHttpRetryDelay

HTTP 再試行遅延を秒単位で設定します。

構文

パラメーター

context   _In_
型: XblContextHandle
設定が関連付けられている XBOX Live コンテキスト。 delayInSeconds   _In_
型: uint32_t
再試行遅延を秒単位で指定します。再試行は指数バックオフを使用して遅延されます。既定では、まず 2 秒間遅延し、次の再試行は 4 秒、その次は 8 秒と遅延し、最大 1 分まで続きます。呼び出しが成功するか、http_timeout_window に達するまで続き、達した時点で呼び出しは失敗します。サービス負荷を分散するため、遅延は現在の遅延と次の遅延の間でジッターが加えられます。http_timeout_window の既定値は 20 秒で、XblContextSettingsSetHttpTimeoutWindow を使用して変更できます。

戻り値

型: HRESULT この API 操作の HRESULT 戻り値コード。

解説

サービスが “Retry-After” ヘッダーを含む HTTP エラーを返す場合、その API への後続のすべての呼び出しは、“Retry-After” の時間に達するまで、サービスに接続せずに元のエラーですぐに失敗します。
ネットワーク エラーが発生した場合、またはサーバーが次のいずれかの HTTP ステータス コードで応答した場合に、べき等なサービス呼び出しが再試行されます:
408 (Request Timeout)
429 (Too Many Requests)
500 (Internal Server Error)
502 (Bad Gateway)
503 (Service Unavailable)
504 (Gateway Timeout)

要件

ヘッダー: xbox_live_context_settings_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

xbox_live_context_settings_c
最終更新日 2026年8月24日