> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblContextSettingsSetHttpRetryDelay

> XblContextSettingsSetHttpRetryDelay

# XblContextSettingsSetHttpRetryDelay

设置以秒为单位的 HTTP 重试延迟。

## 语法

```cpp theme={null}
HRESULT XblContextSettingsSetHttpRetryDelay(  
         XblContextHandle context,  
         uint32_t delayInSeconds  
)  
```

### 参数

*context*   \_In\_\
类型：[XblContextHandle](/reference/live/xsapi-c/types_c/handles/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" 时间为止。<br /> 当发生网络错误或服务器响应以下 HTTP 状态代码之一时，将重试幂等服务调用：<br /> 408 (Request Timeout)<br /> 429 (Too Many Requests)<br /> 500 (Internal Server Error)<br /> 502 (Bad Gateway)<br /> 503 (Service Unavailable)<br /> 504 (Gateway Timeout)<br />

## 要求

**头文件：** xbox\_live\_context\_settings\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[xbox\_live\_context\_settings\_c](/reference/live/xsapi-c/xbox_live_context_settings_c/xbox_live_context_settings_c_members)


## Related topics

- [调用 XBOX 服务的最佳实践](/zh-CN/services/xbox-services/develop/best-practices/live-best-practices-calling-xbl.md)
- [XblContextSettingsGetHttpRetryDelay](/zh-CN/reference/live/xsapi-c/xbox_live_context_settings_c/functions/xblcontextsettingsgethttpretrydelay.md)
- [XblContextSettingsSetHttpTimeoutWindow](/zh-CN/reference/live/xsapi-c/xbox_live_context_settings_c/functions/xblcontextsettingssethttptimeoutwindow.md)
- [XblContextSettingsSetLongHttpTimeout](/zh-CN/reference/live/xsapi-c/xbox_live_context_settings_c/functions/xblcontextsettingssetlonghttptimeout.md)
- [HCHttpCallRequestSetRetryDelay](/zh-CN/reference/live/httpclient/httpclient/functions/hchttpcallrequestsetretrydelay.md)