Freigeben über

ITransferAdviseSink::UpdateProgress-Methode (shobjidl_core.h)

  • Artikel

Updates den Status des Übertragungsfortschritts auf der Benutzeroberfläche.

Syntax

HRESULT UpdateProgress(
  [in] ULONGLONG ullSizeCurrent,
  [in] ULONGLONG ullSizeTotal,
  [in] int       nFilesCurrent,
  [in] int       nFilesTotal,
  [in] int       nFoldersCurrent,
  [in] int       nFoldersTotal
);

Parameter

[in] ullSizeCurrent

Typ: ULONGLONG

Die Anzahl der im aktuellen Vorgang verarbeiteten Bytes.

[in] ullSizeTotal

Typ: ULONGLONG

Die Gesamtanzahl der Bytes im aktuellen Vorgang.

[in] nFilesCurrent

Typ: int

Die Anzahl der im aktuellen Vorgang verarbeiteten Dateien.

[in] nFilesTotal

Typ: int

Die Gesamtanzahl der Dateien im Vorgang. Legen Sie auf 0 fest, um anzugeben, dass sich der Wert seit dem letzten Aufruf dieser Methode nicht geändert hat.

[in] nFoldersCurrent

Typ: int

Die Anzahl der im aktuellen Vorgang verarbeiteten Ordner.

[in] nFoldersTotal

Typ: int

Die Gesamtzahl der Ordner im Vorgang. Legen Sie auf 0 fest, um anzugeben, dass sich der Wert seit dem letzten Aufruf dieser Methode nicht geändert hat.

Rückgabewert

Typ: HRESULT

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

Hinweise

Legen Sie ullSizeTotal, nFilesTotal und nFoldersTotal all auf 0 fest, um anzugeben, dass sich die Summen seit dem letzten Aufruf dieser Methode nicht geändert haben.

Legen Sie alle sechs Parameter auf 0 fest, um anzugeben, dass sich der Fortschritt seit dem letzten Aufruf dieser Methode nicht geändert hat.

Hinweis für Implementierer

Implementierer dieser Funktion sollten einen Fehlercode zurückgeben, wenn der Vorgang beendet werden muss, bevor er abgeschlossen ist, z. B. wenn der Benutzer auf die Schaltfläche Abbrechen klickt.

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 (einschließlich Shobjidl.h)