> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblHttpCallCreate

> XblHttpCallCreate

# XblHttpCallCreate

Crée un handle d'appel HTTP.

## Syntaxe

```cpp theme={null}
HRESULT XblHttpCallCreate(  
         XblContextHandle xblContext,  
         const char* method,  
         const char* url,  
         XblHttpCallHandle* call  
)  
```

### Paramètres

*xblContext*   \_In\_\
Type : [XblContextHandle](https://docs.xbox.com/fr/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

Contexte XBOX Live qui fournit le contexte utilisateur pour autoriser l'appel.

*method*   \_In\_z\_\
Type : char\*

Méthode encodée en UTF-8 de l'appel HTTP.

*url*   \_In\_z\_\
Type : char\*

URL encodée en UTF-8 de l'appel HTTP.

*call*   \_Out\_\
Type : [XblHttpCallHandle\*](https://docs.xbox.com/fr/reference/live/xsapi-c/http_call_c/handles/xblhttpcallhandle.md)

Handle de l'appel HTTP.

### Valeur de retour

Type : HRESULT

Code de résultat de cette opération d'API. Les valeurs possibles sont S\_OK, E\_INVALIDARG ou E\_FAIL.

## Remarques

Commencez par créer un handle HTTP à l'aide de XblHttpCallCreate(). Appelez ensuite XblHttpCallRequestSet\*() pour préparer le XblHttpCallHandle. Appelez ensuite XblHttpCallPerformAsync() pour effectuer l'appel HTTP à l'aide du XblHttpCallHandle. Cet appel est asynchrone : le travail est donc effectué sur un thread d'arrière-plan et le résultat est retourné via le rappel. L'appel d'exécution est asynchrone : le travail est donc effectué sur un thread d'arrière-plan qui appelle XTaskQueueDispatch(..., XTaskQueuePort::Work). Les résultats sont retournés au rappel sur le thread qui appelle XTaskQueueDispatch(..., XTaskQueuePort::Completion). Obtenez ensuite le résultat de l'appel HTTP en appelant XblHttpCallResponseGet\*() pour obtenir la réponse HTTP du XblHttpCallHandle. Lorsque le XblHttpCallHandle n'est plus nécessaire, appelez [XblHttpCallCloseHandle](https://docs.xbox.com/fr/reference/live/xsapi-c/http_call_c/functions/xblhttpcallclosehandle.md) pour libérer la mémoire associée au XblHttpCallHandle.

## Configuration requise

**En-tête :** http\_call\_c.h

**Bibliothèque :** Microsoft.Xbox.Services.14x.GDK.C.lib

## Voir aussi

[http\_call\_c](https://docs.xbox.com/fr/reference/live/xsapi-c/http_call_c/http_call_c_members.md)


## Related topics

- [XblHttpCallPerformAsync](https://docs.xbox.com/fr/reference/live/xsapi-c/http_call_c/functions/xblhttpcallperformasync.md)
- [http_call_c](https://docs.xbox.com/fr/reference/live/xsapi-c/http_call_c/http_call_c_members.md)
- [Vue d'ensemble des requêtes web](https://docs.xbox.com/fr/build/console-features/networking/web-requests/http-networking.md)
- [HCHttpCallCreate](https://docs.xbox.com/fr/reference/live/httpclient/httpclient/functions/hchttpcallcreate.md)
- [XblHttpCallRequestSetLongHttpCall](https://docs.xbox.com/fr/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetlonghttpcall.md)