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

# HCHttpCallRequestSetDynamicSize

> Définit la taille totale à utiliser pour les rapports de progression du chargement lorsque la taille du corps de la requête est dynamique.

# HCHttpCallRequestSetDynamicSize

Marque l'appel HTTP comme ayant un corps de requête de taille dynamique pour le rapport de progression, et définit la taille totale à signaler.

## Syntaxe

```cpp theme={null}
HRESULT HCHttpCallRequestSetDynamicSize(
         HCCallHandle call,
         uint64_t dynamicBodySize
)
```

### Paramètres

*call*   \_In\_\
Type : HCCallHandle

Handle de l'appel HTTP.

*dynamicBodySize*   \_In\_\
Type : uint64\_t

Longueur, en octets, à utiliser comme total pour les rapports de progression du chargement. Doit être supérieure à 0.

### Valeur renvoyée

Type : HRESULT

Code de résultat de cette opération d'API. L'en-tête répertorie `S_OK`, `E_INVALIDARG`, `E_OUTOFMEMORY` ou `E_FAIL`. La fonction renvoie également `E_HC_PERFORM_ALREADY_CALLED` si l'appel a déjà été effectué, et `E_HC_NOT_INITIALISED` si libHttpClient n'est pas initialisé.

## Remarques

Appelez cette fonction avant d'appeler [HCHttpCallPerformAsync](https://docs.xbox.com/fr/reference/live/httpclient/httpclient/functions/hchttpcallperformasync.md). La fonction renvoie `E_INVALIDARG` si *call* est `nullptr` ou si *dynamicBodySize* vaut 0.

Cette fonction fournit un total explicite pour les rapports de progression du chargement. Elle ne modifie pas la longueur du corps de la requête envoyé.

Signalez la progression par rapport à ce total en appelant [HCHttpCallRequestAddDynamicBytesWritten](https://docs.xbox.com/fr/reference/live/httpclient/httpclient/functions/hchttpcallrequestadddynamicbyteswritten.md), généralement à partir de votre rappel [HCHttpCallRequestBodyReadFunction](https://docs.xbox.com/fr/reference/live/httpclient/httpclient/functions/hchttpcallrequestbodyreadfunction.md). Le rappel de progression du chargement que vous définissez avec [HCHttpCallRequestSetProgressReportFunction](https://docs.xbox.com/fr/reference/live/httpclient/httpclient/functions/hchttpcallrequestsetprogressreportfunction.md) reçoit ensuite ces valeurs dans *current* et *total*.

## Configuration requise

**En-tête :** httpClient.h

**Bibliothèque :** libHttpClient.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[httpClient](https://docs.xbox.com/fr/reference/live/httpclient/httpclient/httpclient_members.md)\
[HCHttpCallRequestAddDynamicBytesWritten](https://docs.xbox.com/fr/reference/live/httpclient/httpclient/functions/hchttpcallrequestadddynamicbyteswritten.md)\
[HCHttpCallRequestSetProgressReportFunction](https://docs.xbox.com/fr/reference/live/httpclient/httpclient/functions/hchttpcallrequestsetprogressreportfunction.md)


## Related topics

- [HCHttpCallRequestAddDynamicBytesWritten](https://docs.xbox.com/fr/reference/live/httpclient/httpclient/functions/hchttpcallrequestadddynamicbyteswritten.md)
- [HCHttpCallRequestSetProgressReportFunction](https://docs.xbox.com/fr/reference/live/httpclient/httpclient/functions/hchttpcallrequestsetprogressreportfunction.md)
- [HCHttpCallResponseSetDynamicSize](https://docs.xbox.com/fr/reference/live/httpclient/httpprovider/functions/hchttpcallresponsesetdynamicsize.md)
- [HCHttpCallRequestBodyReadFunction](https://docs.xbox.com/fr/reference/live/httpclient/httpclient/functions/hchttpcallrequestbodyreadfunction.md)
- [HCHttpCallRequestGetDynamicBytesWritten](https://docs.xbox.com/fr/reference/live/httpclient/httpprovider/functions/hchttpcallrequestgetdynamicbyteswritten.md)
