Partager via


CAsyncMonikerFile::OnProgress

Appelé par le moniker à plusieurs reprises pour indiquer le déroulement actuel de cette opération de liaison, généralement à intervalles raisonnables pendant une longue opération.

virtual void OnProgress(
   ULONG ulProgress,
   ULONG ulProgressMax,
   ULONG ulStatusCode,
   LPCTSTR szStatusText 
);

Paramètres

  • ulProgress
    Indique le déroulement actuel de l'opération de liaison par rapport à le nombre maximal attendu indiqué dans ulProgressMax.

  • ulProgressMax
    Indique la valeur maximale destinée à ulProgress pour la durée des appels à OnProgress pour cette opération.

  • ulStatusCode
    Fournit des informations supplémentaires concernant la progression de l'opération de liaison.Les valeurs valides sont prises de l'énumération d' BINDSTATUS .Consultez Notes pour connaitre les valeurs possibles.

  • szStatusText
    Informations sur la progression actuelle, selon la valeur d' ulStatusCode.Consultez Notes pour connaitre les valeurs possibles.

Notes

Les valeurs possibles pour ulStatusCode (et szStatusText pour chaque valeur) sont :

  • BINDSTATUS_FINDINGRESOURCE
    L'opération de liaison recherche la ressource à laquelle juge l'objet ou la mémoire qui est liée.szStatusText fournit le nom complet de la ressource est trouvée pour (par exemple, « www.microsoft.com ").

  • BINDSTATUS_CONNECTING
    L'opération de liaison se connecte à la ressource à laquelle juge l'objet ou la mémoire qui est liée.szStatusText fournit le nom complet de la ressource est connectée (par exemple, une adresse IP).

  • BINDSTATUS_SENDINGREQUEST
    L'opération de liaison demande l'objet ou la mémoire qui est liée à.szStatusText fournit le nom complet de l'objet (par exemple, un nom de fichier).

  • BINDSTATUS_REDIRECTING
    L'opération de liaison a été redirigée vers une colocalisation des données différente.szStatusText fournit le nom complet de la nouvelle colocalisation des données.

  • BINDSTATUS_USINGCACHEDCOPY
    L'opération de liaison récupère l'objet ou la mémoire demandé d'une copie mise en cache.szStatusText est NULL.

  • BINDSTATUS_BEGINDOWNLOADDATA
    L'opération de liaison a démarré réception l'objet ou la mémoire qui est liée à.szStatusText fournit le nom complet de la colocalisation des données.

  • BINDSTATUS_DOWNLOADINGDATA
    L'opération de liaison continue à recevoir l'objet ou la mémoire qui est liée à.szStatusText fournit le nom complet de la colocalisation des données.

  • BINDSTATUS_ENDDOWNLOADDATA
    L'opération de liaison a terminé de recevoir l'objet ou la mémoire qui est liée à.szStatusText fournit le nom complet de la colocalisation des données.

  • BINDSTATUS_CLASSIDAVAILABLE
    Une instance de l'objet qui est lié à est sur le point juste d'être créée.szStatusText fournit le CLSID du nouvel objet au format de chaîne, ce qui permet au client la possibilité d'annuler l'opération de liaison, si vous le souhaitez.

Configuration requise

Header: afxole.h

Voir aussi

Référence

Classe de CAsyncMonikerFile

Graphique de la hiérarchie