Skip to main content

​
XblHttpCallPerformAsync

XblHttpCallHandle을 사용하여 HTTP 호출을 수행합니다.

​
구문

​
매개 변수

call   _In_
형식: XblHttpCallHandle HTTP 호출의 핸들입니다. type   _In_
형식: XblHttpCallResponseBodyType 이 HTTP 호출의 결과를 읽는 응답 본문 형식입니다. 참고: 이는 content-type 헤더에 영향을 주지 않으며 content-type 헤더는 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
마지막 수정일 2026년 8월 13일

관련 항목

XblHttpCallRequestSetLongHttpCallXblHttpCallGetResponseStringXblHttpCallRequestSetHeaderXblHttpCallGetHeaderXblHttpCallGetResponseBodyBytes