Freigeben über

IControlProgressHandler

  • Artikel

Diese Schnittstelle ist ein clientseitiger Handler, der Aktualisierungen erhält, wenn die Bibliothek eine Operation ausführt. Die Bibliothek führt dann synchrone Rückrufe an den Client aus, die den Fortschritt der Operation anzeigen. Abhängig von der Benutzeraktion weist der Client-Rückgabecode die Bibliothek an, die Operation entweder fortzusetzen oder abzubrechen. Dieser Prozess ermöglicht es der Benutzeroberfläche, dem Benutzer den Fortschritt langer Vorgänge wie Speichern anzuzeigen. Wenn der Benutzer den Vorgang abbricht, gibt die UI den entsprechenden Code an die Bibliothek zurück.

Syntax

{
  [id(1), helpstring("OnBegin")] HRESULT OnBegin();
  [id(2), helpstring("OnUpdate")] HRESULT OnUpdate
    ([in] ULONG CurrentValuePercent);
  [id(3), helpstring("OnEnd")] HRESULT OnEnd
    ([in] HRESULT hrResult);
};

Functions

In der folgenden Tabelle werden die Funktionen beschrieben, die diese Schnittstelle bereitstellt.

Funktion Beschreibung

OnBegin

Weist die Bibliothek an, eine Operation zu starten.

OnUpdate

Weist die Bibliothek an, den Fortschritt eines Vorgangs fortzusetzen.

OnEnd

Gibt einen Statuscode nach dem Ende eines Vorgangs zurück.

Schnittstellen