Compartir a través de


CAsyncMonikerFile::OnProgress

Llamado por el moniker repetidamente para indicar el progreso actual de la operación de enlace, normalmente en intervalos razonables durante una operación larga.

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

Parámetros

  • ulProgress
    Indica el progreso actual de la operación de enlace en relación con el máximo esperado indicado en ulProgressMax.

  • ulProgressMax
    Indica el valor máximo esperado de ulProgress para la duración de las llamadas a OnProgress para esta operación.

  • ulStatusCode
    Proporciona información adicional con respecto al progreso de la operación de enlace. los valores válidos se toman de la enumeración de BINDSTATUS . Para obtener los valores posibles, vea la sección Comentarios.

  • szStatusText
    Información sobre el progreso actual, dependiendo del valor de ulStatusCode. Para obtener los valores posibles, vea la sección Comentarios.

Comentarios

los valores posibles para ulStatusCode (y szStatusText por cada valor) son:

  • BINDSTATUS_FINDINGRESOURCE
    La operación de enlace detecta el recurso al que contiene el objeto o el almacenamiento que está enlazado. szStatusText proporciona el nombre para mostrar del recurso que se esté buscando (por ejemplo, “www.microsoft.com ").

  • BINDSTATUS_CONNECTING
    La operación de enlace está conectando con el recurso al que contiene el objeto o el almacenamiento que está enlazado. szStatusText proporciona el nombre para mostrar del recurso que está conectada a (por ejemplo, dirección IP).

  • BINDSTATUS_SENDINGREQUEST
    La operación de enlace se soliciten el objeto o el almacén que se enlaza a. szStatusText proporciona el nombre para mostrar del objeto (por ejemplo, un nombre de archivo).

  • BINDSTATUS_REDIRECTING
    La operación de enlace se ha redirigido a otra ubicación de datos. szStatusText proporciona el nombre para mostrar de la nueva ubicación de los datos.

  • BINDSTATUS_USINGCACHEDCOPY
    La operación de enlace vuelve al objeto o el almacenamiento solicitado de una copia en caché. szStatusText es NULL.

  • BINDSTATUS_BEGINDOWNLOADDATA
    La operación de enlace ha iniciado recibiendo el objeto o el almacenamiento que era enlazado a. szStatusText proporciona el nombre para mostrar de la ubicación de los datos.

  • BINDSTATUS_DOWNLOADINGDATA
    La operación de enlace continúa recibiendo el objeto o el almacén que se enlaza a. szStatusText proporciona el nombre para mostrar de la ubicación de los datos.

  • BINDSTATUS_ENDDOWNLOADDATA
    La operación de enlace ha terminado de recibir el objeto o el almacenamiento que era enlazado a. szStatusText proporciona el nombre para mostrar de la ubicación de los datos.

  • BINDSTATUS_CLASSIDAVAILABLE
    Una instancia del objeto que se va a realizar solo a punto de crearse. szStatusText proporciona el CLSID del nuevo objeto en formato de cadena, que les permita no solamente lograr el cliente la oportunidad de cancelar la operación de enlace, si lo desea.

Requisitos

encabezado: afxole.h

Vea también

Referencia

CAsyncMonikerFile Class

Gráfico de jerarquías