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日