> ## 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](/zh-TW/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](/zh-TW/reference/live/xsapi-c/http_call_c/functions/xblhttpcallperformasync) 之前呼叫此函式。

## 需求

**標頭：** http\_call\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

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


## Related topics

- [XblHttpCallRequestSetHeader](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetheader.md)
- [XblHttpCallPerformAsync](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallperformasync.md)
- [HTTP and WebSocket web requests in the GDK](/build/console-features/networking/web-requests/http-networking.md)