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
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épertorieS_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. La fonction renvoieE_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, généralement à partir de votre rappel HCHttpCallRequestBodyReadFunction. Le rappel de progression du chargement que vous définissez avec HCHttpCallRequestSetProgressReportFunction 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 SeriesVoir aussi
httpClientHCHttpCallRequestAddDynamicBytesWritten
HCHttpCallRequestSetProgressReportFunction