Compartir a través de


Método IActionProgress::UpdateProgress (shobjidl_core.h)

Novedades el progreso de una acción en la interfaz de usuario.

Sintaxis

HRESULT UpdateProgress(
  [in] ULONGLONG ulCompleted,
  [in] ULONGLONG ulTotal
);

Parámetros

[in] ulCompleted

Tipo: ULONGLONG

Cantidad de la acción completada.

[in] ulTotal

Tipo: ULONGLONG

Cantidad total de la acción.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error de lo contrario.

Comentarios

Se debe llamar a este método periódicamente para actualizar el progreso de la acción. La clase de implementación puede interpretar estos valores de cualquier manera deseados, aunque los valores de ulCompleted y ulTotal deben interpretarse entre sí para determinar una cantidad de progreso significativa. A menudo, se desea un porcentaje, en cuyo caso el valor de ulCompleted debe dividirse por ulTotal y el resultado multiplicado por un valor de 100.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)
Archivo DLL Shobjidl.idl