> ## 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](/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\*](/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\*() 获取 XblHttpCallHandle 的 HTTP 响应，从而获取 HTTP 调用的结果。当不再需要 XblHttpCallHandle 时，调用 [XblHttpCallCloseHandle](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallclosehandle) 以释放与 XblHttpCallHandle 关联的内存。

## 要求

**头文件：** 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)
- [HCHttpCallCreate](/zh-CN/reference/live/httpclient/httpclient/functions/hchttpcallcreate.md)
- [XblHttpCallRequestSetLongHttpCall](/zh-CN/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetlonghttpcall.md)
- [XblHttpCallGetHeader](/zh-CN/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetheader.md)
- [XblHttpCallCloseHandle](/zh-CN/reference/live/xsapi-c/http_call_c/functions/xblhttpcallclosehandle.md)