IMAPIProgress::GetMin
Gilt für: Outlook 2013 | Outlook 2016
Gibt den Mindestwert in der IMAPIProgress::SetLimits-Methode an, für die Statusinformationen angezeigt werden.
HRESULT GetMin(
ULONG FAR * lpulMin
);
Parameter
lpulMin
[out] Ein Verweis auf die minimale Anzahl von Elementen in dem Vorgang.
Rückgabewert
S_OK
Die minimale Anzahl von Elementen in dem Vorgang wurde abgerufen.
Hinweise
Der Mindestwert stellt den Beginn 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 Statusobjekt versteht, dass der Mindestwert lokal oder global ist. Wenn das MAPI_TOP_LEVEL-Flag festgelegt ist, wird der Mindestwert als global betrachtet und zum Berechnen des Status für den gesamten Vorgang verwendet. Wenn MAPI_TOP_LEVEL nicht festgelegt ist, wird der Mindestwert als lokal betrachtet und von Anbietern intern verwendet, um den Status von Unterobjekten auf niedrigeren Ebenen anzuzeigen. Statusobjekte speichern den lokalen Mindestwert nur, um diesen an einen Anbieter über einen GetMin-Aufruf zurückzugeben.
Hinweise für Implementierer
Initialisieren Sie den Mindestwert auf 1. Dienstanbieter können diesen Wert durch Aufrufen der IMAPIProgress::SetLimits-Methode zurücksetzen. Weitere Informationen zum Implementieren von GetMin 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.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIProgress.cpp |
CMAPIProgress::GetMin |
MFCMAPI verwendet die IMAPIProgress::GetMin-Methode, um den kleinsten Wert für die Statusanzeige abzurufen. Gibt 1 zurück, es sei denn, zuvor wurden durch Aufrufen der IMAPIProgress::SetLimits-Methode Einschränkungen festgelegt. |