> ## 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.

# XblHttpCallRequestSetRetryCacheId

> XblHttpCallRequestSetRetryCacheId

# XblHttpCallRequestSetRetryCacheId

此 REST 终结点的 ID 号，用于缓存 Retry-After 标头以实现快速失败。

## 语法

```cpp theme={null}
HRESULT XblHttpCallRequestSetRetryCacheId(  
         XblHttpCallHandle call,  
         uint32_t retryAfterCacheId  
)  
```

### 参数

*call*   \_In\_\
类型：[XblHttpCallHandle](/reference/live/xsapi-c/http_call_c/handles/xblhttpcallhandle)

HTTP 调用的句柄。传入 nullptr 可设置将来调用的默认值。

*retryAfterCacheId*   \_In\_\
类型：uint32\_t

此 REST 终结点的 ID 号，用于缓存 Retry-After 标头以实现快速失败。1-1000 已保留给 XSAPI 使用。

### 返回值

类型：HRESULT

此 API 操作的结果代码。可能的值为 S\_OK、E\_INVALIDARG 或 E\_FAIL。

## 备注

必须在调用 [XblHttpCallPerformAsync](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallperformasync) 之前调用此函数。

## 要求

**头文件：** http\_call\_c.h

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

## 另请参阅

[http\_call\_c](/reference/live/xsapi-c/http_call_c/http_call_c_members)


## Related topics

- [HCHttpCallRequestSetRetryCacheId](/zh-CN/reference/live/httpclient/httpclient/functions/hchttpcallrequestsetretrycacheid.md)
- [HCHttpCallRequestGetRetryCacheId](/zh-CN/reference/live/httpclient/httpprovider/functions/hchttpcallrequestgetretrycacheid.md)
- [XblHttpCallRequestSetRetryAllowed](/zh-CN/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetretryallowed.md)
- [HCHttpCallRequestSetRetryDelay](/zh-CN/reference/live/httpclient/httpclient/functions/hchttpcallrequestsetretrydelay.md)
- [HCHttpCallRequestSetRetryAllowed](/zh-CN/reference/live/httpclient/httpclient/functions/hchttpcallrequestsetretryallowed.md)
