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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | reconcil.h |
| DLL | Shell32.dll (Version 4.0 oder höher) |