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

Novedades el estado de progreso de la transferencia en la interfaz de usuario.

Sintaxis

HRESULT UpdateProgress(
  [in] ULONGLONG ullSizeCurrent,
  [in] ULONGLONG ullSizeTotal,
  [in] int       nFilesCurrent,
  [in] int       nFilesTotal,
  [in] int       nFoldersCurrent,
  [in] int       nFoldersTotal
);

Parámetros

[in] ullSizeCurrent

Tipo: ULONGLONG

Número de bytes procesados en la operación actual.

[in] ullSizeTotal

Tipo: ULONGLONG

Número total de bytes en la operación actual.

[in] nFilesCurrent

Tipo: int

Número de archivos procesados en la operación actual.

[in] nFilesTotal

Tipo: int

Número total de archivos en la operación. Establezca en 0 para indicar que el valor no ha cambiado desde la última llamada a este método.

[in] nFoldersCurrent

Tipo: int

Número de carpetas procesadas en la operación actual.

[in] nFoldersTotal

Tipo: int

Número total de carpetas de la operación. Establezca en 0 para indicar que el valor no ha cambiado desde la última llamada a este método.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Establezca ullSizeTotal, nFilesTotal y nFoldersTotal en 0 para indicar que los totales no han cambiado desde la última llamada a este método.

Establezca los seis parámetros en 0 para indicar que el progreso no ha cambiado desde la última llamada a este método.

Nota para los implementadores

Los implementadores de esta función deben devolver un código de error cuando la operación necesite finalizar antes de que se complete, como cuando el usuario hace clic en el botón Cancelar .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)