Skip to main content

​
XblHttpCallPerformAsync

XblHttpCallHandle を使用して HTTP 呼び出しを実行します。

​
構文

​
パラメーター

call   _In_
型: XblHttpCallHandle HTTP 呼び出しのハンドル。 type   _In_
型: XblHttpCallResponseBodyType この HTTP 呼び出しの結果を読み取るための応答本文の型。注: これは content-type ヘッダーには影響しません。content-type ヘッダーは XblHttpCallRequestSetHeader を呼び出して指定する必要があります。 asyncBlock   _Inout_
型: XAsyncBlock* 非同期操作を定義する XAsyncBlock。

​
戻り値

型: HRESULT この API 操作の結果コード。有効な値は S_OK、E_INVALIDARG、E_OUTOFMEMORY、または E_FAIL です。

​
解説

まず XblHttpCallCreate() を使用して HTTP ハンドルを作成します。次に XblHttpCallRequestSet*() を呼び出して XblHttpCallHandle を準備します。次に XblHttpCallPerformAsync() を呼び出して、XblHttpCallHandle を使用して HTTP 呼び出しを実行します。この呼び出しは非同期であるため、処理はバックグラウンド スレッドで行われ、コールバック経由で戻ります。perform 呼び出しは非同期であり、処理は XTaskQueueDispatch(…, XTaskQueuePort::Work) を呼び出すバックグラウンド スレッドで行われます。結果は XTaskQueueDispatch(…, XTaskQueuePort::Completion) を呼び出すスレッド上のコールバックに返されます。その後、XblHttpCallResponseGet*() を呼び出して XblHttpCallHandle の HTTP 応答を取得することで HTTP 呼び出しの結果を取得します。XblHttpCallHandle が不要になったら、XblHttpCallCloseHandle() を呼び出して XblHttpCallHandle に関連付けられたメモリを解放します。XblHttpCallPerformAsync は一度しか呼び出すことができません。呼び出しを繰り返すには、新しい XblHttpCallHandle を作成してください。

​
要件

ヘッダー: http_call_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

​
関連項目

http_call_c
最終更新日 2026年8月13日

関連トピック

XblHttpCallRequestSetLongHttpCallXblHttpCallGetResponseStringXblHttpCallRequestSetHeaderXblHttpCallGetResponseBodyBytesXblHttpCallGetHeader