IMAPISupport::DoProgressDialog
Gilt für: Outlook 2013 | Outlook 2016
Ruft ein Statusobjekt ab, das eine Statusanzeige anzeigt.
HRESULT DoProgressDialog(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPMAPIPROGRESS FAR * lppProgress
);
Parameter
ulUIParam
[in] Ein Handle für das übergeordnete Fenster der Statusanzeige.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie das Statusobjekt den Fortschritt berechnen soll. Das folgende Flag kann festgelegt werden:
MAPI_TOP_LEVEL
Der Fortschritt wird für ein Element der obersten Ebene berechnet, z. B. für einen übergeordneten Ordner. Das progress-Objekt sollte die Werte in den ulCount- und ulTotal-Parametern der IMAPIProgress::P rogress-Methode verwenden, die jeweils das aktuelle Element bzw. die Gesamtelemente im Vorgang angeben, um die Statusanzeige für den Vorgang zu erhöhen.
lppProgress
[out] Ein Zeiger auf einen Zeiger auf das Statusobjekt.
Rückgabewert
S_OK
Das Statusobjekt wurde erfolgreich abgerufen.
Hinweise
Die IMAPISupport::D oProgressDialog-Methode wird für Adressbuch- und Nachrichtenspeicheranbieter-Unterstützungsobjekte implementiert. Diese Anbieter rufen DoProgressDialog auf, um auf die MAPI-Implementierung der IMAPIProgress-Schnittstelle zuzugreifen, die die Statusinformationen berechnet und ein Standarddialogfeld anzeigt.
Informationen zur Verwendung eines Statusobjekts und der IMAPIProgress-Schnittstelle finden Sie unter Anzeigen eines Statusindikators.