MAPI-Dienstanbieter
Gilt für: Outlook 2013 | Outlook 2016
Es gibt drei gängige Arten von Dienstanbietern:
Adressbuchanbieter.
Nachrichtenspeicheranbieter.
Transportanbieter.
Adressbuch- und Nachrichtenspeicheranbieter weisen viele Ähnlichkeiten auf. Sie registrieren einen eindeutigen Bezeichner bei DER MAPI, den sie zum Erstellen von Eingabebezeichnern für ihre Objekte verwenden. Sie stellen eine Hierarchie von Objekten und Eigenschaften bereit, auf die Clients zugreifen und diese bearbeiten können. Für ihre Containerobjekte unterstützen sie eine Hierarchietabelle und eine Inhaltstabelle. Sie unterstützen Ereignisbenachrichtigungen für diese Tabellen und optional für einzelne Objekte, sodass Clients über Änderungen informiert werden können, die während der Sitzung auftreten. Wenn Vorgänge langwierig werden, können sie eine Statusanzeige anzeigen, um den Benutzer über die status des Vorgangs zu informieren. Clients können mit Adressbuch- und Nachrichtenspeicheranbietern entweder indirekt über MAPI über die Schnittstellen IAddrBook : IMAPIProp und IMAPISession : IUnknown oder direkt über eine der Dienstanbieterschnittstellen in der folgenden Tabelle kommunizieren.
| Adressbuchanbieterschnittstellen | Schnittstellen des Nachrichtenspeicheranbieters |
|---|---|
| IABContainer : IMAPIContainer |
IMsgStore: IMAPIProp |
| IDistList : IMAPIContainer |
IMAPIFolder : IMAPIContainer |
| IMailUser : IMAPIProp |
IMessage: IMAPIProp |
| IAttach : IMAPIProp |
Transportanbieter unterscheiden sich von Adressbuch- und Nachrichtenspeicheranbietern in der Art und Weise, wie sie mit MAPI und mit Clients kommunizieren. Transportanbieter warten in der Regel darauf, dass MAPI sie zur Eingabe von Informationen auffordert, anstatt die Kommunikation zu initiieren. Im Gegensatz zu den anderen Anbietern unterstützen Transportanbieter keine Vielzahl von Objekten und Tabellen, auf die häufig von Clients zugegriffen wird. Sie unterstützen jedoch wie alle Dienstanbieter ein status-Objekt und veröffentlichen seine Eigenschaften in der status Tabelle. Während Adressbuch- und Nachrichtenspeicheranbieter die IMAPISupport::SetProviderUID-Methode aufrufen, um eindeutige Bezeichner für die Erstellung ihrer Eintragsbezeichner zu registrieren, rufen Transportanbieter die IXPLogon::AddressTypes-Methode auf, um eindeutige Bezeichner sowie Adresstypen für die Übernahme der Verantwortung für die Zustellung bestimmter Nachrichten zu registrieren.
Ihr Dienstanbieter sollte über drei Headerdateien verfügen: eine öffentliche Headerdatei und zwei interne Dateien. Verwenden Sie die öffentliche Headerdatei für die Konfiguration und zum Dokumentieren von Eigenschaften und deren Werten. Schließen Sie alle erforderlichen öffentlichen MAPI-Header in eine der internen Headerdateien ein. Diese Headerdatei sollte in allen Quelldateien ihres Dienstanbieters enthalten sein. Verwenden Sie die andere interne Datei, um Ressourcenbezeichner zu definieren.
Adressbuch-, Nachrichtenspeicher- und Transportanbieter führen die folgenden Aufgaben aus:
Geben Sie eine Einstiegspunktfunktion an.
Geben Sie einen Anbieter und ein Anmeldeobjekt an, um die Anmeldung und Initialisierung zu verarbeiten.
Wenn der Anbieter zu einem Nachrichtendienst gehört, geben Sie eine Einstiegspunktfunktion des Nachrichtendiensts an.
Unterstützung der Konfiguration durch Implementieren eines Eigenschaftenblatts.
Implementieren Sie ein status-Objekt, und unterstützen Sie die status Tabelle.
Handle heruntergefahren.