> ## 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

Executa uma chamada HTTP usando o XblHttpCallHandle.

## Sintaxe

```cpp theme={null}
HRESULT XblHttpCallPerformAsync(  
         XblHttpCallHandle call,  
         XblHttpCallResponseBodyType type,  
         XAsyncBlock* asyncBlock  
)  
```

### Parâmetros

*call*   \_In\_\
Tipo: [XblHttpCallHandle](/pt-BR/reference/live/xsapi-c/http_call_c/handles/xblhttpcallhandle)

O identificador da chamada HTTP.

*type*   \_In\_\
Tipo: [XblHttpCallResponseBodyType](/pt-BR/reference/live/xsapi-c/http_call_c/enums/xblhttpcallresponsebodytype)

O tipo de corpo da resposta para ler os resultados desta chamada HTTP. Observação: isso não influencia o cabeçalho content-type, que deve ser fornecido chamando [XblHttpCallRequestSetHeader](/pt-BR/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetheader).

*asyncBlock*   \_Inout\_\
Tipo: XAsyncBlock\*

O XAsyncBlock que define a operação assíncrona.

### Valor retornado

Tipo: HRESULT

Código de resultado desta operação de API. Os valores possíveis são S\_OK, E\_INVALIDARG, E\_OUTOFMEMORY ou E\_FAIL.

## Comentários

Primeiro, crie um identificador HTTP usando XblHttpCallCreate(). Em seguida, chame XblHttpCallRequestSet\*() para preparar o XblHttpCallHandle. Depois, chame XblHttpCallPerformAsync() para executar a chamada HTTP usando o XblHttpCallHandle. Essa chamada é assíncrona, portanto, o trabalho será feito em um thread em segundo plano e retornará por meio do retorno de chamada. A chamada de execução é assíncrona, portanto, o trabalho será feito em um thread em segundo plano que chama XTaskQueueDispatch(..., XTaskQueuePort::Work). Os resultados retornarão ao retorno de chamada no thread que chama XTaskQueueDispatch(..., XTaskQueuePort::Completion); em seguida, obtenha o resultado da chamada HTTP chamando XblHttpCallResponseGet\*() para obter a resposta HTTP do XblHttpCallHandle. Quando o XblHttpCallHandle não for mais necessário, chame XblHttpCallCloseHandle() para liberar a memória associada ao XblHttpCallHandle. XblHttpCallPerformAsync só pode ser chamado uma vez. Crie um novo XblHttpCallHandle para repetir a chamada.

## Requisitos

**Cabeçalho:** http\_call\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Confira também

[http\_call\_c](/pt-BR/reference/live/xsapi-c/http_call_c/http_call_c_members)


## Related topics

- [XblHttpCallPerformAsync](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallperformasync.md)
- [XblHttpCallRequestSetLongHttpCall](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetlonghttpcall.md)
- [XblHttpCallGetResponseString](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetresponsestring.md)
- [XblHttpCallGetResponseBodyBytes](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetresponsebodybytes.md)