ITransferAdviseSink：：UpdateProgress 方法 (shobjidl_core.h)

在 UI 中汇报传输进度状态。

语法

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

参数

[in] ullSizeCurrent

类型： ULONGLONG

在当前操作中处理的字节数。

[in] ullSizeTotal

类型： ULONGLONG

当前操作中的字节总数。

[in] nFilesCurrent

类型： int

在当前操作中处理的文件数。

[in] nFilesTotal

类型： int

操作中的文件总数。 设置为 0 表示自上次调用此方法以来，该值未更改。

[in] nFoldersCurrent

类型： int

在当前操作中处理的文件夹数。

[in] nFoldersTotal

类型： int

操作中的文件夹总数。 设置为 0 表示自上次调用此方法以来，该值未更改。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

将 ullSizeTotal、 nFilesTotal 和 nFoldersTotal 全部设置为 0，表示自上次调用此方法以来，总计未更改。

将所有六个参数设置为 0，以指示自上次调用此方法以来进度没有更改。

对实现者的说明

当操作需要在操作完成之前终止时，例如当用户单击“ 取消 ”按钮时，此函数的实现者应返回错误代码。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	shobjidl_core.h (包括 Shobjidl.h)