> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblHttpCallCreate

> XblHttpCallCreate

# XblHttpCallCreate

HTTP 呼び出しハンドルを作成します。

## 構文

```cpp theme={null}
HRESULT XblHttpCallCreate(  
         XblContextHandle xblContext,  
         const char* method,  
         const char* url,  
         XblHttpCallHandle* call  
)  
```

### パラメーター

*xblContext*   \_In\_\
型: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

呼び出しを承認するためのユーザー コンテキストを提供する XBOX Live コンテキスト。

*method*   \_In\_z\_\
型: char\*

HTTP 呼び出しの UTF-8 エンコードされたメソッド。

*url*   \_In\_z\_\
型: char\*

HTTP 呼び出しの UTF-8 エンコードされた URL。

*call*   \_Out\_\
型: [XblHttpCallHandle\*](/reference/live/xsapi-c/http_call_c/handles/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](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallclosehandle) を呼び出して XblHttpCallHandle に関連付けられたメモリを解放します。

## 要件

**ヘッダー:** http\_call\_c.h

**ライブラリ:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 関連項目

[http\_call\_c](/reference/live/xsapi-c/http_call_c/http_call_c_members)


## Related topics

- [XblHttpCallPerformAsync](/ja-jp/reference/live/xsapi-c/http_call_c/functions/xblhttpcallperformasync.md)
- [HCHttpCallCreate](/ja-jp/reference/live/httpclient/httpclient/functions/hchttpcallcreate.md)
- [XblHttpCallRequestSetLongHttpCall](/ja-jp/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetlonghttpcall.md)
- [XblHttpCallDuplicateHandle](/ja-jp/reference/live/xsapi-c/http_call_c/functions/xblhttpcallduplicatehandle.md)
- [XblHttpCallCloseHandle](/ja-jp/reference/live/xsapi-c/http_call_c/functions/xblhttpcallclosehandle.md)