Skip to main content

​
XblHttpCallCreate

HTTP 호출 핸들을 만듭니다.

​
구문

​
매개 변수

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 호출을 수행합니다. 이 호출은 비동기이므로 작업은 백그라운드 스레드에서 수행되며 콜백을 통해 반환됩니다. Perform 호출은 비동기이므로 작업은 XTaskQueueDispatch(…, XTaskQueuePort::Work)를 호출하는 백그라운드 스레드에서 수행됩니다. 결과는 XTaskQueueDispatch(…, XTaskQueuePort::Completion)를 호출하는 스레드에서 콜백으로 반환된 다음, XblHttpCallResponseGet*()을 호출하여 XblHttpCallHandle의 HTTP 응답을 가져와 HTTP 호출의 결과를 얻습니다. XblHttpCallHandle이 더 이상 필요하지 않을 때는 XblHttpCallCloseHandle을 호출하여 XblHttpCallHandle과 연결된 메모리를 해제합니다.

​
요구 사항

헤더: http_call_c.h 라이브러리: Microsoft.Xbox.Services.14x.GDK.C.lib

​
참고 항목

http_call_c
마지막 수정일 2026년 8월 24일

관련 항목

XblHttpCallPerformAsyncHCHttpCallCreateXblHttpCallRequestSetLongHttpCallXblHttpCallGetHeaderXblHttpCallCloseHandle