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

Realiza una llamada HTTP mediante el XblHttpCallHandle.

## Sintaxis

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

### Parámetros

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

El identificador de la llamada HTTP.

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

El tipo de cuerpo de la respuesta con el que se leerán los resultados de esta llamada HTTP. Nota: esto no influye en el encabezado content-type, que debe proporcionarse llamando a [XblHttpCallRequestSetHeader](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetheader).

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

El XAsyncBlock que define la operación asincrónica.

### Valor devuelto

Tipo: HRESULT

Código de resultado para esta operación de API. Los valores posibles son S\_OK, E\_INVALIDARG, E\_OUTOFMEMORY o E\_FAIL.

## Comentarios

Primero cree un identificador HTTP mediante XblHttpCallCreate(). A continuación, llame a XblHttpCallRequestSet\*() para preparar el XblHttpCallHandle. Después, llame a XblHttpCallPerformAsync() para realizar la llamada HTTP mediante el XblHttpCallHandle. Esta llamada es asincrónica, por lo que el trabajo se realizará en un subproceso en segundo plano y se devolverá a través de la devolución de llamada. La llamada de ejecución es asincrónica, por lo que el trabajo se realizará en un subproceso en segundo plano que llama a XTaskQueueDispatch(..., XTaskQueuePort::Work). Los resultados se devolverán a la devolución de llamada en el subproceso que llama a XTaskQueueDispatch(..., XTaskQueuePort::Completion); después, obtenga el resultado de la llamada HTTP llamando a XblHttpCallResponseGet\*() para obtener la respuesta HTTP del XblHttpCallHandle. Cuando ya no se necesite el XblHttpCallHandle, llame a XblHttpCallCloseHandle() para liberar la memoria asociada con el XblHttpCallHandle. Solo se puede llamar a XblHttpCallPerformAsync una vez. Cree un nuevo XblHttpCallHandle para repetir la llamada.

## Requisitos

**Encabezado:** http\_call\_c.h

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

## Consulte también

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


## Related topics

- [XblHttpCallRequestSetLongHttpCall](/es/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetlonghttpcall.md)
- [XblHttpCallGetResponseString](/es/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetresponsestring.md)
- [XblHttpCallGetResponseBodyBytes](/es/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetresponsebodybytes.md)
- [XblHttpCallRequestSetHeader](/es/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetheader.md)
- [XblHttpCallGetHeader](/es/reference/live/xsapi-c/http_call_c/functions/xblhttpcallgetheader.md)