通过

XblHttpCallCreate

  • 项目

创建 HTTP 调用句柄。

语法

HRESULT XblHttpCallCreate(  
         XblContextHandle xblContext,  
         const char* method,  
         const char* url,  
         XblHttpCallHandle* call  
)

参数

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