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

# XblContextSettingsGetHttpRetryDelay

> XblContextSettingsGetHttpRetryDelay

# XblContextSettingsGetHttpRetryDelay

获取 HTTP 重试延迟（秒）。

## 语法

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

### 参数

*context*   \_In\_\
类型：[XblContextHandle](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

与设置关联的 XBOX Live 上下文。

*delayInSeconds*   \_Out\_\
类型：uint32\_t\*

回传重试延迟（秒）。重试使用指数退避进行延迟。默认情况下，第一次延迟 2 秒，下一次重试延迟 4 秒，然后 8 秒，依此类推，直到最大 1 分钟，直到调用成功或达到 http\_timeout\_window，此时调用将失败。延迟还会在当前延迟和下一次延迟之间加入抖动以分散服务负载。http\_timeout\_window 的默认值为 20 秒，可以使用 XblContextSettingsSetHttpTimeoutWindow 进行更改。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

如果服务返回带有 “Retry-After” 标头的 HTTP 错误，则对该 API 的所有未来调用将立即以原始错误失败，且在达到 “Retry-After” 时间之前不会联系服务。\
&#x20;当发生网络错误或服务器响应以下 HTTP 状态代码之一时，将重试幂等的服务调用：\
&#x20;408 (Request Timeout)\
&#x20;429 (Too Many Requests)\
&#x20;500 (Internal Server Error)\
&#x20;502 (Bad Gateway)\
&#x20;503 (Service Unavailable)\
&#x20;504 (Gateway Timeout)\


## 要求

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

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

## 另请参阅

[xbox\_live\_context\_settings\_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/xbox_live_context_settings_c/xbox_live_context_settings_c_members.md)


## Related topics

- [xbox_live_context_settings_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/xbox_live_context_settings_c/xbox_live_context_settings_c_members.md)
- [XblContextSettingsSetHttpRetryDelay](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/xbox_live_context_settings_c/functions/xblcontextsettingssethttpretrydelay.md)
- [XblContextSettingsGetLongHttpTimeout](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/xbox_live_context_settings_c/functions/xblcontextsettingsgetlonghttptimeout.md)
- [XblContextSettingsGetHttpTimeoutWindow](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/xbox_live_context_settings_c/functions/xblcontextsettingsgethttptimeoutwindow.md)
- [HCHttpCallRequestGetRetryDelay](https://docs.xbox.com/zh-CN/reference/live/httpclient/httpprovider/functions/hchttpcallrequestgetretrydelay.md)
