> ## 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](/ko/reference/live/xsapi-c/http_call_c/functions/xblhttpcallperformasync.md)
- [HCHttpCallCreate](/ko/reference/live/httpclient/httpclient/functions/hchttpcallcreate.md)
- [XblHttpCallRequestSetLongHttpCall](/ko/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetlonghttpcall.md)
- [XblHttpCallGetHeader](/ko/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetheader.md)
- [XblHttpCallCloseHandle](/ko/reference/live/xsapi-c/http_call_c/functions/xblhttpcallclosehandle.md)