IReconcileInitiator::SetProgressFeedback-Methode (reconcil.h)

Gibt den Fortschritt an, den der Aktenkoffer-Abgleich beim Abschluss der Abstimmung erzielt hat. Die Menge ist ein Bruchteil und wird als Quotient der Parameter ulProgress und ulProgressMax berechnet. Abgleichser sollten diese Methode während ihres Abstimmungsprozesses regelmäßig aufrufen.

Syntax

HRESULT SetProgressFeedback(
  ULONG ulProgress,
  ULONG ulProgressMax
);

Parameter

ulProgress

Typ: ULONG

Der Zähler des Fortschrittsbruchteils.

ulProgressMax

Typ: ULONG

Der Nenner des Fortschrittsanteils.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolgreicher Ausführung den S_OK Wert oder den E_UNEXPECTED Wert zurück, wenn ein nicht angegebener Fehler aufgetreten ist.

Hinweise

Der Initiator verwendet dieses Fortschrittsmaß in der Regel, um ein Thermometermessgerät oder eine andere Form des visuellen Feedbacks für den Benutzer zu aktualisieren. Der Aktenkoffer-Abgleich kann den Wert von ulProgressMax von Aufruf in Aufruf ändern. Dies bedeutet, dass aufeinander folgende Aufrufe dieser Methode nicht unbedingt auf einen stetigen Fortschritt hinweisen. Rückschritte sind zwar legal, aber nicht wünschenswert. Es liegt in der Verantwortung des Initiators zu bestimmen, ob der Rückwärtsfortschritt dem Benutzer angezeigt werden soll.

Anforderungen

Weitere Informationen

IReconcileInitiator