IMAPIProgress::GetMax
Gilt für: Outlook 2013 | Outlook 2016
Gibt die maximale Anzahl von Elementen im Vorgang zurück, für die Statusinformationen angezeigt werden.
HRESULT GetMax(
ULONG FAR * lpulMax
);
Parameter
lpulMax
[out] Ein Zeiger auf die maximale Anzahl von Elementen im Vorgang.
Rückgabewert
S_OK
Die maximale Anzahl von Elementen im Vorgang wurde abgerufen.
Hinweise
Der Maximalwert stellt das Ende des Vorgangs in numerischer Form dar. Der Wert kann ein globaler Maximalwert sein, der verwendet wird, um den Umfang der gesamten Statusanzeige darzustellen, oder ein lokaler Wert, der zum Darstellen eines Teils der Anzeige verwendet wird.
Der Wert der Flageinstellung wirkt sich darauf aus, ob das Progress-Objekt versteht, dass der Maximalwert lokal oder global ist. Wenn das MAPI_TOP_LEVEL-Flag festgelegt ist, wird der Maximalwert als global betrachtet und verwendet, um den Fortschritt für den gesamten Vorgang zu berechnen. Wenn MAPI_TOP_LEVEL nicht festgelegt ist, wird der Maximalwert als lokal betrachtet, und Anbieter verwenden ihn intern, um den Fortschritt für Untergeordnete Objekte auf niedrigerer Ebene anzuzeigen. Progress-Objekte speichern den lokalen Maximalwert nur, um ihn über einen GetMax-Aufruf an einen Anbieter zurückzugeben.
Weitere Informationen dazu, wie und wann Statusobjekte aufgerufen werden, finden Sie unter Anzeigen einer Statusanzeige.
Hinweise für Implementierer
Initialisieren Sie den Höchstwert auf 1000. Dienstanbieter können diesen Wert durch Aufrufen der IMAPIProgress::SetLimits-Methode zurücksetzen. Weitere Informationen zum Implementieren von GetMax und den anderen IMAPIProgress-Methoden finden Sie unter Implementieren eines Statusindikators.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIProgress.cpp |
CMAPIProgress::GetMax |
MFCMAPI verwendet die IMAPIProgress::GetMax-Methode , um den Maximalwert für das Statusobjekt abzurufen. Gibt 1000 zurück, es sei denn, die Grenzwerte wurden zuvor mit der IMAPIProgress::SetLimits-Methode festgelegt. |