IProgressDialog::Timer 方法 (shlobj_core.h)

将进度对话框计时器重置为零。

语法

HRESULT Timer(
  [in] DWORD   dwTimerAction,
       LPCVOID pvResevered
);

参数

[in] dwTimerAction

类型:DWORD

指示计时器要执行的操作的标志。 以下值之一:

PDTIMER_RESET

将计时器重置为零。 将从调用此方法时开始计算进度。

PDTIMER_PAUSE

进度已暂停。

PDTIMER_RESUME

已恢复进展。

pvResevered

类型: LPCVOID

保留。 设置为 NULL。

返回值

类型: HRESULT

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

注解

计时器用于估计剩余时间。 它在应用程序调用 IProgressDialog::StartProgressDialog 时启动。 除非应用程序立即启动,否则它应在开始操作之前调用 Timer 。 这种做法可确保时间估算尽可能准确。 首次调用 IProgressDialog::SetProgress 后,不应调用此方法。

要求

要求
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h
DLL Shell32.dll (5.0 或更高版本)

另请参阅

IProgressDialog