IProgressDialog::Timer-Methode (shlobj_core.h)
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) |