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

# XblHttpCallRequestSetHeader

> XblHttpCallRequestSetHeader

# XblHttpCallRequestSetHeader

为 HTTP 调用设置请求标头。

## 语法

```cpp theme={null}
HRESULT XblHttpCallRequestSetHeader(  
         XblHttpCallHandle call,  
         const char* headerName,  
         const char* headerValue,  
         bool allowTracing  
)  
```

### 参数

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

HTTP 调用的句柄。

*headerName*   \_In\_z\_\
类型：char\*

HTTP 调用的 UTF-8 编码请求标头名称。

*headerValue*   \_In\_z\_\
类型：char\*

HTTP 调用的 UTF-8 编码请求标头值。

*allowTracing*   \_In\_\
类型：bool

设置为 false 可跳过跟踪此请求标头，例如当该标头包含私密信息时。

### 返回值

类型：HRESULT

此 API 操作的结果代码。可能的值为 S\_OK、E\_INVALIDARG、E\_OUTOFMEMORY 或 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

- [XblHttpCallPerformAsync](/zh-CN/reference/live/xsapi-c/http_call_c/functions/xblhttpcallperformasync.md)
- [HCHttpCallRequestSetHeader](/zh-CN/reference/live/httpclient/httpclient/functions/hchttpcallrequestsetheader.md)
- [XblHttpCallRequestSetLongHttpCall](/zh-CN/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetlonghttpcall.md)
- [XblHttpCallRequestSetRequestBodyBytes](/zh-CN/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetrequestbodybytes.md)
- [XblHttpCallRequestSetRequestBodyString](/zh-CN/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetrequestbodystring.md)