Skip to main content

XblContextSettingsGetHttpRetryDelay

获取 HTTP 重试延迟(秒)。

语法

参数

context   _In_
类型:XblContextHandle
与设置关联的 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” 时间之前不会联系服务。
当发生网络错误或服务器响应以下 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日