IActionProgress::UpdateProgress-Methode (shobjidl_core.h)

  • Artikel

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