> ## 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](/ko/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetlonghttpcall.md)
- [XblHttpCallGetResponseString](/ko/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetresponsestring.md)
- [XblHttpCallRequestSetHeader](/ko/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetheader.md)
- [XblHttpCallGetHeader](/ko/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetheader.md)
- [XblHttpCallGetResponseBodyBytes](/ko/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetresponsebodybytes.md)