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*() 取得 HTTP 呼叫的結果，以取得 XblHttpCallHandle 的 HTTP 回應。當不再需要 XblHttpCallHandle 時，請呼叫 XblHttpCallCloseHandle 以釋放與 XblHttpCallHandle 相關聯的記憶體。

​
需求

標頭： http_call_c.h 程式庫： Microsoft.Xbox.Services.14x.GDK.C.lib

​
另請參閱

http_call_c
Last modified on October 6, 2026