IActionProgress::UpdateProgress-Methode (shobjidl_core.h)

Artikel
03/06/2024

Updates den Fortschritt einer Aktion auf der Benutzeroberfläche.

Syntax

HRESULT UpdateProgress(
  [in] ULONGLONG ulCompleted,
  [in] ULONGLONG ulTotal
);

Parameter

[in] ulCompleted

Typ: ULONGLONG

Der Umfang der abgeschlossenen Aktion.

[in] ulTotal

Typ: ULONGLONG

Der Gesamtbetrag der Aktion.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn erfolgreich, oder andernfalls einen Fehlerwert.

Hinweise

Diese Methode sollte in regelmäßigen Abständen aufgerufen werden, um den Status der Aktion zu aktualisieren. Die implementierende Klasse kann diese Werte beliebig interpretieren, obwohl die Werte von ulCompleted und ulTotal relativ zueinander interpretiert werden sollten, um einen aussagekräftigen Fortschritt zu bestimmen. Häufig wird ein Prozentsatz gewünscht. In diesem Fall sollte der Wert von ulCompleted durch ulTotal und das Ergebnis mit einem Wert von 100 multipliziert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shobjidl.idl

Freigeben über