IMAPIProgress::SetLimits

Gilt für: Outlook 2013 | Outlook 2016

Legt die Unter- und Obergrenze für die Anzahl der Elemente im Vorgang sowie die Flags fest, die steuern, wie Statusinformationen für den Vorgang berechnet werden.

HRESULT SetLimits(
  LPULONG lpulMin,
  LPULONG lpulMax,
  LPULONG lpulFlags
);

Parameter

lpulMin

[in] Ein Zeiger auf eine Variable, die die untere Grenze von Elementen im Vorgang enthält.

lpulMax

[in] Ein Zeiger auf eine Variable, die die Obergrenze der Elemente im Vorgang enthält.

lpulFlags

[in] Eine Bitmaske von Flags, die die Vorgangsebene steuert, auf der Fortschrittsinformationen berechnet werden. Das folgende Flag kann festgelegt werden:

MAPI_TOP_LEVEL

Verwendet die Werte in den Parametern IMAPIProgress::ProgressulCount der Methode und ulTotal, die das aktuell verarbeitete Element bzw. die Gesamtelemente angeben, um den Fortschritt des Vorgangs zu erhöhen. Wenn dieses Flag festgelegt ist, müssen die Werte der globalen Unter- und Obergrenze festgelegt werden.

Rückgabewert

S_OK

Der Aufruf erfolgreich ausgeführt und der erwartete Wert oder Werte zurückgegeben hat.

Hinweise

Dienstanbieter rufen die Methode IMAPIProgress::SetLimits auf, um das MAPI_TOP_LEVEL-Flag festzulegen oder zu löschen und lokale und globale Mindest- und Höchstwerte festzulegen. Der Wert der Flageinstellung wirkt sich darauf aus, ob das Statusobjekt versteht, dass der Mindestwert lokal oder global ist. Wenn das MAPI_TOP_LEVEL-Flag festgelegt ist, werden diese Werte als global betrachtet und zur Berechnung des Fortschritts für den gesamten Vorgang verwendet. Progress-Objekte initialisieren den globalen Mindestwert auf 1 und den globalen Höchstwert auf 1000.

Wenn MAPI_TOP_LEVEL nicht festgelegt ist, werden die Mindest- und Höchstwerte als lokal betrachtet, und Anbieter verwenden sie intern, um den Status für Unterobjekte auf niedrigerer Ebene anzuzeigen. Statusobjekte speichern die lokalen Minimal- und Höchstwerte nur so, dass sie an Anbieter zurückgegeben werden können, wenn die IMAPIProgress::GetMin und IMAPIProgress::GetMax-Methoden aufgerufen werden.

Weitere Informationen zum Implementieren SetLimits und der anderen IMAPIProgress-Methoden finden Sie unter Implementieren eines Statusindikators.

Weitere Informationen dazu, wie und wann Statusobjekte aufgerufen werden, finden Sie unter Anzeigen einer Statusanzeige.

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Siehe auch

IMAPIProgress::GetMaxIMAPIProgress::GetMin
IMAPIProgress::Progress
IMAPIProgress : IUnknownMFCMAPI als Codebeispiel
Anzeigen einer Statusanzeige
Implementieren eines Statusindikators