IFileOperationProgressSink::UpdateProgress-Methode (shobjidl_core.h)

Artikel
03/04/2024

Stellt eine Schätzung der gesamt geleisteten Arbeit im Verhältnis zur Gesamtarbeitssumme bereit.

Syntax

HRESULT UpdateProgress(
  [in] UINT iWorkTotal,
  [in] UINT iWorkSoFar
);

Parameter

[in] iWorkTotal

Typ: UINT

Eine Schätzung des Zu erledigenden Arbeitsaufwands.

[in] iWorkSoFar

Typ: UINT

Der Teil von iWorkTotal , der bisher abgeschlossen wurde.

Rückgabewert

Typ: HRESULT

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

Hinweise

Die Werte "iWorkTotal " und "iWorkSoFar " sind "Punkte" oder Schätzungen für den Zu erledigenden Arbeitsaufwand und den Umfang der Abgeschlossenen. Sie werden nicht in bestimmten Einheiten angegeben, sollten aber in etwa proportional zur Dauer des Gesamtprozesses sein. Das Kopieren einer kleinen Datei kann beispielsweise als zwei Punkte betrachtet werden, und eine große Datei kann als zehn Punkte betrachtet werden. Wenn ein Prozess einen Vorgang ausführt, der fünf kleine Dateien und eine große Datei kopiert, und der Prozess vier der kleinen Dateien abgeschlossen hat, würde iWorkSoFar acht Punkte (4 x 2 = 8) und iWorkTotal wäre zwanzig Punkte (5 x 2 + 10 = 20), sodass die Schätzung 8 von 20 Punkten (oder 40 %) abgeschlossen wäre.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Share via