Skip to main content

​
XblHttpCallCreate

Creates an HTTP call handle.

​
Syntax

​
Parameters

xblContext   _In_
Type: XblContextHandle XBOX Live context that provides user context for authorizing the call. method   _In_z_
Type: char* UTF-8 encoded method for the HTTP call. url   _In_z_
Type: char* UTF-8 encoded URL for the HTTP call. call   _Out_
Type: XblHttpCallHandle* The handle of the HTTP call.

​
Return value

Type: HRESULT Result code for this API operation. Possible values are S_OK, E_INVALIDARG, or E_FAIL.

​
Remarks

First create an HTTP handle using XblHttpCallCreate(). Then call XblHttpCallRequestSet*() to prepare the XblHttpCallHandle. Then call XblHttpCallPerformAsync() to perform HTTP call using the XblHttpCallHandle. This call is asynchronous, so the work will be done on a background thread and will return via the callback. The perform call is asynchronous, so the work will be done on a background thread which calls XTaskQueueDispatch(…, XTaskQueuePort::Work). The results will return to the callback on the thread that calls XTaskQueueDispatch(…, XTaskQueuePort::Completion), then get the result of the HTTP call by calling XblHttpCallResponseGet*() to get the HTTP response of the XblHttpCallHandle. When the XblHttpCallHandle is no longer needed, call XblHttpCallCloseHandle to free the memory associated with the XblHttpCallHandle.

​
Requirements

Header: http_call_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

​
See also

http_call_c
Last modified on August 20, 2026

Related topics

XblHttpCallPerformAsyncHCHttpCallCreateXblHttpCallRequestSetLongHttpCallXblHttpCallGetHeaderXblHttpCallDuplicateHandle