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 呼び出しを実行します。この呼び出しは非同期であるため、処理はバックグラウンド スレッドで行われ、コールバック経由で戻ります。perform 呼び出しは非同期であり、処理は 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日