다음을 통해 공유

XblHttpCallCreate

  • 아티클

HTTP 호출 핸들을 생성합니다.

구문

HRESULT XblHttpCallCreate(  
         XblContextHandle xblContext,  
         const char* method,  
         const char* url,  
         XblHttpCallHandle* call  
)

매개 변수

xblContext _In_
형식: XblContextHandle

호출 인증을 위한 사용자 컨텍스트를 제공하는 Xbox Live 컨텍스트입니다.

method _In_z_
형식: char*

HTTP 호출에 대한 UTF-8로 인코딩된 메서드입니다.

url _In_z_
형식: char*

HTTP 호출에 대한 UTF-8로 인코딩된 URL입니다.

호출 _Out_
유형: XblHttpCallHandle*

HTTP 호출의 핸들입니다.

반환 값

형식: HRESULT

이 API 작업에 대한 결과 코드입니다. 가능한 값은 S_OK, E_INVALIDARG 또는 E_FAIL입니다.

설명

우선 XblHttpCallCreate()를 사용하여 HTTP 핸들을 생성합니다. 그런 다음 XblHttpCallRequestSet*()를 호출하여 XblHttpCallHandle을 준비합니다. 그런 다음 XblHttpCallPerformAsync()를 호출하여 XblHttpCallHandle을 사용하여 HTTP 호출을 수행합니다. 이 호출은 비동기식이므로 백그라운드 스레드에서 작업이 수행되고 콜백을 통해 반환됩니다. 수행 호출은 비동기식이므로 작업은 XTaskQueueDispatch(..., XTaskQueuePort::Work)를 호출하는 백그라운드 스레드에서 수행됩니다. 결과는 XTaskQueueDispatch(..., XTaskQueuePort::Completion)를 호출하는 스레드의 콜백으로 반환된 다음 XblHttpCallHandle의 HTTP 응답을 가져오기 위해 XblHttpCallResponseGet*()를 호출하여 HTTP 호출의 결과를 가져옵니다. XblHttpCallHandle이 더 이상 필요하지 않으면 XblHttpCallCloseHandle을 호출하여 XblHttpCallHandle과 연결된 메모리를 해제합니다.

요건

헤더: http_call_c.h

도서관: Microsoft.Xbox.Services.14x.GDK.C.lib

참고 항목

http_call_c