IMAPIProgress::SetLimits

Artikel
04/04/2023

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 Statusinformationen berechnet werden. Das folgende Flag kann festgelegt werden:

MAPI_TOP_LEVEL

Verwendet die Werte in den UlCount- und ulTotal-Parametern der IMAPIProgress::P rogress-Methode, 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 IMAPIProgress::SetLimits-Methode 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 Progress-Objekt versteht, dass die minimalen und maximalen Werte lokal oder global sind. Wenn das MAPI_TOP_LEVEL-Flag festgelegt ist, werden diese Werte als global betrachtet und zum Berechnen 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 Minimal- und Höchstwerte als lokal betrachtet, und Anbieter verwenden sie intern, um den Fortschritt für Untergeordnete Objekte auf niedrigerer Ebene anzuzeigen. Progress-Objekte speichern nur die lokalen Mindest- und Höchstwerte, damit sie an Anbieter zurückgegeben werden können, wenn die Methoden IMAPIProgress::GetMin und IMAPIProgress::GetMax aufgerufen werden.

Weitere Informationen zum Implementieren von SetLimits und den 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.

Datei	Funktion	Kommentar
MAPIProgress.cpp	CMAPIProgress::SetLimits	MFCMAPI verwendet die IMAPIProgress::SetLimits-Methode , um die maximalen und minimalen Grenzwerte und Flags für das Statusobjekt festzulegen.

Siehe auch

IMAPIProgress::GetMax IMAPIProgress::GetMin
IMAPIProgress::Progress
IMAPIProgress : IUnknown MFCMAPI als Codebeispiel
Anzeigen einer Statusanzeige
Implementieren eines Statusindikators

Freigeben über