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

# XblHttpCallCreate

> XblHttpCallCreate

# XblHttpCallCreate

建立 HTTP 呼叫控制代碼。

## 語法

```cpp theme={null}
HRESULT XblHttpCallCreate(  
         XblContextHandle xblContext,  
         const char* method,  
         const char* url,  
         XblHttpCallHandle* call  
)  
```

### 參數

*xblContext*   \_In\_\
類型：[XblContextHandle](/zh-TW/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

提供使用者內容以授權呼叫的 XBOX Live 內容。

*method*   \_In\_z\_\
類型：char\*

HTTP 呼叫的 UTF-8 編碼方法。

*url*   \_In\_z\_\
類型：char\*

HTTP 呼叫的 UTF-8 編碼 URL。

*call*   \_Out\_\
類型：[XblHttpCallHandle\*](/zh-TW/reference/live/xsapi-c/http_call_c/handles/xblhttpcallhandle)

HTTP 呼叫的控制代碼。

### 傳回值

類型：HRESULT

此 API 作業的結果碼。可能的值為 S\_OK、E\_INVALIDARG 或 E\_FAIL。

## 備註

首先使用 XblHttpCallCreate() 建立 HTTP 控制代碼。接著呼叫 XblHttpCallRequestSet\*() 以準備 XblHttpCallHandle。然後呼叫 XblHttpCallPerformAsync()，使用 XblHttpCallHandle 執行 HTTP 呼叫。此呼叫為非同步，因此工作會在背景執行緒上完成，並透過回呼傳回。執行呼叫為非同步，因此工作會在呼叫 XTaskQueueDispatch(..., XTaskQueuePort::Work) 的背景執行緒上完成。結果會在呼叫 XTaskQueueDispatch(..., XTaskQueuePort::Completion) 的執行緒上傳回給回呼，然後呼叫 XblHttpCallResponseGet\*() 取得 HTTP 呼叫的結果，以取得 XblHttpCallHandle 的 HTTP 回應。當不再需要 XblHttpCallHandle 時，請呼叫 [XblHttpCallCloseHandle](/zh-TW/reference/live/xsapi-c/http_call_c/functions/xblhttpcallclosehandle) 以釋放與 XblHttpCallHandle 相關聯的記憶體。

## 需求

**標頭：** 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

- [XblHttpCallCreate](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallcreate.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)