Starten eines Dienstanbieters
Gilt für: Outlook 2013 | Outlook 2016
Nachdem ein Client eine Sitzung mit MAPI gestartet hat, wird Ihr Dienstanbieter gestartet. Transportanbieter werden gestartet, wenn ein Client eine Anforderung für seine Dienste sendet. Adressbuch- und Nachrichtenspeicheranbieter werden während des Anmeldevorgangs des Clients gestartet.
Ein Client ruft IMAPISession::OpenAddressBook auf, um jeden der im Profil enthaltenen Adressbuchanbieter zu laden, und IMAPISession::OpenMsgStore , um einen bestimmten Nachrichtenspeicheranbieter zu laden. Adressbuchanbieter, die Teil eines Nachrichtendiensts sind, werden vor einem der anderen Anbieter im Dienst gestartet.
MAPI startet jeden Dienstanbieter im aktiven Profil wie folgt:
Suchen des Namens der DLL im Profil. Sie müssen den Namen Ihrer Anbieter-DLL in der Konfigurationsdatei Mapisvc.inf registrieren, um sicherzustellen, dass er im Profil angezeigt wird. Wenn Ihr Dienstanbieter entweder einzeln oder als Teil eines Nachrichtendiensts einem Profil hinzugefügt wird, werden alle [Dienstanbieter] -Abschnitte aus Mapisvc.inf, die für Ihren Anbieter gelten, in das Profil kopiert. Weitere Informationen zur Struktur von Mapisvc.inf finden Sie unter Dateiformat von MapiSvc.inf.
Aufrufen der Windows-API-Funktion LoadLibrary zum Laden der DLL. Da MAPI LoadLibrary entweder jedes Mal aufruft, wenn eine Dienstanbieter-DLL verwendet wird (unabhängig davon, ob sie bereits geladen wurde) oder nur beim ersten Mal, darf Ihr Dienstanbieter keine Annahmen darüber treffen, wie oft sie geladen wird. Bei jedem Aufruf von LoadLibrary ruft MAPI die Windows-API-Funktion FreeLibrary auf, wenn keine Dienstanbieter-DLL mehr benötigt wird.
Aufrufen der Einstiegspunktfunktion für den Anbieter. MAPI ruft die Einstiegspunktfunktion Ihres Anbieters auf, um den Anmeldevorgang zu initiieren. Einstiegspunktfunktionen stellen sicher, dass Sie eine Version der Dienstanbieterschnittstelle (SERVICE Provider Interface, SPI) verwenden, die mit der version kompatibel ist, die von MAPI verwendet wird. Diese Funktionen geben auch Zeiger auf neu erstellte Anbieterobjekte zurück. Weitere Informationen zum Erstellen einer Einstiegspunktfunktion für Ihren Anbieter finden Sie unter Implementieren einer Dienstanbietereinstiegspunktfunktion.