Skip to main content

​
XblHttpCallCreate

创建 HTTP 调用句柄。

​
语法

​
参数

xblContext   _In_
类型：XblContextHandle XBOX Live 上下文，用于为该调用提供用户身份验证上下文。 method   _In_z_
类型：char* HTTP 调用的 UTF-8 编码方法。 url   _In_z_
类型：char* HTTP 调用的 UTF-8 编码 URL。 call   _Out_
类型：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 以释放与 XblHttpCallHandle 关联的内存。

​
要求

头文件： http_call_c.h 库： Microsoft.Xbox.Services.14x.GDK.C.lib

​
另请参阅

http_call_c
最后修改于 2026年8月24日

相关主题

XblHttpCallPerformAsyncHCHttpCallCreateXblHttpCallRequestSetLongHttpCallXblHttpCallGetHeaderXblHttpCallCloseHandle