> ## 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.

# XblHttpCallPerformAsync

> XblHttpCallPerformAsync

# XblHttpCallPerformAsync

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

## 構文

```cpp theme={null}
HRESULT XblHttpCallPerformAsync(  
         XblHttpCallHandle call,  
         XblHttpCallResponseBodyType type,  
         XAsyncBlock* asyncBlock  
)  
```

### パラメーター

*call*   \_In\_\
型: [XblHttpCallHandle](/reference/live/xsapi-c/http_call_c/handles/xblhttpcallhandle)

HTTP 呼び出しのハンドル。

*type*   \_In\_\
型: [XblHttpCallResponseBodyType](/reference/live/xsapi-c/http_call_c/enums/xblhttpcallresponsebodytype)

この HTTP 呼び出しの結果を読み取るための応答本文の型。注: これは content-type ヘッダーには影響しません。content-type ヘッダーは [XblHttpCallRequestSetHeader](/reference/live/xsapi-c/http_call_c/functions/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](/reference/live/xsapi-c/http_call_c/http_call_c_members)


## Related topics

- [XblHttpCallRequestSetLongHttpCall](/ja-jp/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetlonghttpcall.md)
- [XblHttpCallGetResponseString](/ja-jp/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetresponsestring.md)
- [XblHttpCallRequestSetHeader](/ja-jp/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetheader.md)
- [XblHttpCallGetResponseBodyBytes](/ja-jp/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetresponsebodybytes.md)
- [XblHttpCallGetHeader](/ja-jp/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetheader.md)