IMAPIProgress : IUnknown
Gilt für: Outlook 2013 | Outlook 2016
Implementiert ein Statusobjekt, das Clientanwendungen eine Statusanzeige bereitstellt. Eine Statusanzeige ist eine Anzeige der Benutzeroberfläche, 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 |
Updates die Statusanzeige mit einer Anzeige des Fortschritts bis zum Abschluss des Vorgangs. |
| GetFlags |
Gibt Flageinstellungen aus dem Statusobjekt für die Vorgangsebene zurück, auf der Statusinformationen berechnet werden. |
| GetMax |
Gibt die maximale Anzahl von Elementen im Vorgang zurück, für die Statusinformationen angezeigt werden. |
| GetMin |
Gibt den Mindestwert in der SetLimits-Methode zurück, für den Statusinformationen angezeigt werden. |
| SetLimits |
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. |
Hinweise
MAPI enthält einen lpProgress-Parameter in vielen Methoden, die potenziell langwierige Vorgänge ausführen. lpProgress verweist auf eine Clientimplementierung eines Statusobjekts. Clients, die die IMAPIProgress-Schnittstelle 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 | Funktion | Kommentar |
|---|---|---|
| MapiProgress.h und MapiProgress.cpp |
Nicht zutreffend |
Wenn die EINSTELLUNG IMAPIProgress aktiviert ist, übergibt MFCMAPI eine IMAPIProgress-Implementierung an alle Funktionen, die MFCMAPI aufruft und eine Implementierung akzeptieren. |