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.141.GSDK.C.lib

関連項目

http_call_c