HCHttpCallProgressReportFunction
Rappel défini par l’application qui reçoit des mises à jour de progression pendant qu’un appel HTTP charge ou télécharge un corps.Syntaxe
Paramètres
call _In_Type : HCCallHandle Handle de l’appel HTTP. current _In_
Type : uint64_t Nombre d’octets chargés ou téléchargés jusqu’à présent. total _In_
Type : uint64_t Taille totale, en octets, du corps en cours de chargement ou de téléchargement. context _In_opt_
Type : void* Pointeur de contexte que vous avez passé à HCHttpCallRequestSetProgressReportFunction.
Valeur renvoyée
Type : HRESULT RenvoyezS_OK pour continuer. Sur le fournisseur WinHTTP intégré, un HRESULT d’échec met fin à la tentative en cours et est enregistré comme erreur réseau de l’appel. La stratégie normale de nouvelle tentative peut démarrer une autre tentative.
Remarques
Inscrivez le rappel avec HCHttpCallRequestSetProgressReportFunction. libHttpClient l’appelle sur un thread d’arrière-plan non spécifié qui dépend de la plateforme ; veillez donc à ce que le rappel reste court et rendez tout état partagé thread-safe. Pour la progression du chargement, si vous définissez une taille dynamique de corps de requête avec HCHttpCallRequestSetDynamicSize, total correspond à cette taille et current correspond au total cumulé que vous signalez avec HCHttpCallRequestAddDynamicBytesWritten. Sur le fournisseur WinHTTP intégré, la progression du téléchargement n’est pas signalée lorsque la réponse n’a pas de Content-Length positif.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
httpClientHCHttpCallRequestSetProgressReportFunction