IProgressDialog::Timer-Methode (shlobj_core.h)

  • Artikel

Setzt den Statusdialogzeitgeber auf 0 zurück.

Syntax

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

Parameter

[in] dwTimerAction

Art: DWORD

Flags, die die aktion angeben, die vom Timer ausgeführt werden soll. Einer der folgenden Werte:

PDTIMER_RESET

Setzt den Timer auf 0 zurück. Der Fortschritt wird ab dem Aufruf dieser Methode berechnet.

PDTIMER_PAUSE

Der Fortschritt wurde angehalten.

PDTIMER_RESUME

Der Fortschritt wurde fortgesetzt.

pvResevered

Typ: LPCVOID

Reserviert. Auf NULL festgelegt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Timer wird verwendet, um die verbleibende Zeit zu schätzen. Es wird gestartet, wenn Ihre Anwendung IProgressDialog::StartProgressDialog aufruft. Sofern Ihre Anwendung nicht sofort gestartet wird, sollte sie den Timer kurz vor dem Starten des Vorgangs aufrufen. Dadurch wird sichergestellt, dass die Zeitschätzungen so genau wie möglich sind. Diese Methode sollte nicht nach dem ersten Aufruf von IProgressDialog::SetProgress aufgerufen werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h
DLL Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

IProgressDialog