Freigeben über


IMAPIProgress : IUnknown

Gilt für: Outlook 2013 | Outlook 2016

Implementiert ein Statusobjekt, das Clientanwendungen eine Statusanzeige bereitstellt. Eine Statusanzeige ist eine Benutzeroberflächenanzeige, die den Prozentsatz des Abschlusses eines Vorgangs anzeigt, z. B. das Kopieren von Ordnern zwischen Nachrichtenspeichern. MAPI- und Clientanwendungen implementieren Statusobjekte und Dienstanbieter verwenden sie.

Eigenschaft Wert
Headerdatei
Mapidefs.h
Verfügbar gemacht von:
Statusobjekte
Implementiert von:
MAPI und Clientanwendungen
Aufgerufen von:
Dienstanbieter
Schnittstellenbezeichner:
IID_IMAPIProgress
Zeigertyp:
LPMAPIPROGRESS

Vtable-Reihenfolge

Member Beschreibung
Progress
Aktualisiert die Statusanzeige mit einer Anzeige des Fortschritts bis zum Abschluss des Vorgangs.
GetFlags
Gibt Flageinstellungen aus dem Statusobjekt für die Vorgangsebene zurück, für die Statusinformationen berechnet werden.
GetMax
Gibt die maximale Anzahl von Elementen im Vorgang zurück, für die Statusinformationen angezeigt werden.
GetMin
Gibt den Minimalwert in der Methode SetLimits zurück, für die Statusinformationen angezeigt werden.
SetLimits
Legt die Unter- und Obergrenzen für die Anzahl der Elemente im Vorgang sowie die Flags fest, die steuern, wie Statusinformationen für den Vorgang berechnet werden.

Hinweise

MAPI enthält einen lpProgress-Parameter in vielen Methoden, die potenziell lange Vorgänge ausführen. lpProgress verweist auf eine Clientimplementierung eines Statusobjekts. Clients, die die Schnittstelle IMAPIProgress implementieren, legen diesen Parameter so fest, dass er auf ihre Implementierung verweist. Clients, die IMAPIProgress nicht implementieren, legen den Parameter auf NULL fest. Um während der Verarbeitung des Vorgangs eine Statusanzeige anzuzeigen, verwenden Dienstanbieter das vom Client bereitgestellte Statusobjekt, sofern verfügbar, oder eine MAPI-Implementierung (angegeben, wenn lpProgress auf NULL festgelegt ist).

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Files Function Kommentar
MapiProgress.h und MapiProgress.cpp
Nicht zutreffend
Wenn die IMAPIProgress-Einstellung aktiviert ist, übergibt MFCMAPI eine IMAPIProgress-Implementierung an alle Funktionen, die MFCMAPI aufruft, die eine Implementierung akzeptieren.

Siehe auch

MFCMAPI (engl.) als ein Codebeispiel

MAPI-Schnittstellen