Fonction CfReportProviderProgress (cfapi.h)

Permet à un fournisseur de synchronisation de signaler la progression hors bande.

Syntaxe

HRESULT CfReportProviderProgress(
  [in] CF_CONNECTION_KEY ConnectionKey,
  [in] CF_TRANSFER_KEY   TransferKey,
  [in] LARGE_INTEGER     ProviderProgressTotal,
  [in] LARGE_INTEGER     ProviderProgressCompleted
);

Paramètres

[in] ConnectionKey

Clé de connexion représentant un canal de communication avec le filtre de synchronisation.

[in] TransferKey

Handle opaque pour l’espace réservé.

[in] ProviderProgressTotal

Progression totale du fournisseur de synchronisation en réponse à un rappel de récupération de données.

[in] ProviderProgressCompleted

Progression terminée du fournisseur de synchronisation en réponse à un rappel de récupération de données.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le filtre suit automatiquement la progression des hydratations, en suivant les plages qui sont transférées et/ou reconnues en réponse à FETCH_DATA rappels. Toutefois, si un fournisseur passe la majeure partie de son temps à télécharger du contenu vers un emplacement temporaire avant de commencer à TRANSFER_DATA au filtre, le filtre ignore sinon que ces activités sont liées de quelque manière que ce soit à la demande.

En appelant régulièrement CfReportProviderProgress , le fournisseur de synchronisation peut signaler la progression au filtre, réinitialisant ainsi le délai d’expiration de 60 secondes correspondant au rappel CF_CALLBACK_TYPE_FETCH_DATA . Cela rendra également la progression plus fluide.

Configuration requise

Voir aussi

CfReportProviderProgress2

CF_CALLBACK_TYPE