Compartir a través de

IControlProgressHandler

  • Artículo

Esta interfaz es un controlador del lado cliente que recibe actualizaciones cuando la biblioteca realiza una operación. A continuación, la biblioteca ejecuta devoluciones de llamada sincrónicas al cliente que indican el progreso de la operación. En función de la acción del usuario, el código de retorno del cliente indica a la biblioteca que continúe la operación o que la cancele. Este proceso permite a la interfaz de usuario mostrar al usuario el progreso de operaciones largas, como Guardar. Si el usuario decide cancelar la operación, la interfaz de usuario devuelve el código correspondiente a la biblioteca.

Sintaxis

{
  [id(1), helpstring("OnBegin")] HRESULT OnBegin();
  [id(2), helpstring("OnUpdate")] HRESULT OnUpdate
    ([in] ULONG CurrentValuePercent);
  [id(3), helpstring("OnEnd")] HRESULT OnEnd
    ([in] HRESULT hrResult);
};

Functions

En la tabla siguiente se describen las funciones que proporciona esta interfaz.

Función Descripción

OnBegin

Indica a la biblioteca que inicie una operación.

OnUpdate

Indica a la biblioteca que continúe el progreso de una operación.

OnEnd

Devuelve un código de estado después del final de una operación.

Interfaces