Freigeben über

Implementieren einer Einstiegspunktfunktion des Adressbuchanbieters

  • Artikel

Gilt für: Outlook 2013 | Outlook 2016

Wenn eine Clientanwendung MAPILogonEx aufruft, um eine Sitzung mit einem Profil zu beginnen, das Ihren Adressbuchanbieter enthält, lädt MAPI Ihren Anbieter und alle anderen, die Teil des Profils sind. MAPI lernt den Namen der Einstiegspunktfunktion Ihres Anbieters, indem sie im Profil nachschaut. Denken Sie daran, dass diese Funktion nicht mit einer DLL-Einstiegspunktfunktion identisch ist. Weitere Informationen finden Sie in der Dokumentation zu DllMain in der Win32-Dokumentation.

Es gibt mehrere Einträge, von denen einige in der Konfigurationsdatei mapisvc.inf enthalten sein müssen, die im Profilabschnitt jedes Adressbuchanbieters enthalten sind. In der folgenden Tabelle sind diese Profilabschnittseinträge aufgeführt, und es wird angegeben, ob sie in der Datei mapisvc.inf enthalten sein müssen.

Profilabschnittseintrag mapisvc.inf-Anforderung
PR_DISPLAY_NAME= string
Optional
PR_PROVIDER_DISPLAY= string
Erforderlich
PR_PROVIDER_DLL_NAME= DLL-Dateiname
Erforderlich
PR_RESOURCE_TYPE= long
Erforderlich
PR_RESOURCE_FLAGS= Bitmaske
Optional

Ihr Adressbuchanbieter kann diese Informationen direkt in einem Profil platzieren, indem er die IMAPIProp::SetProps-Methode seines Profilabschnitts aufruft oder indirekt durch Ändern von MAPISVC.INF. Profile werden mithilfe der relevanten Informationen in MAPISVC erstellt. INF für die ausgewählten Dienstanbieter oder Nachrichtendienste. Weitere Informationen zu den organization und Inhalten von MAPISVC. INF, siehe Dateiformat von MapiSvc.inf.

Der Name der DLL-Einstiegspunktfunktion Ihres Adressbuchanbieters muss ABProviderInit sein und dem ABProviderInit-Prototyp entsprechen. Führen Sie die folgenden Aufgaben in der DLL-Einstiegspunktfunktion Ihres Anbieters aus:

  • Überprüfen Sie die Version der Dienstanbieterschnittstelle (SERVICE Provider Interface, SPI), um sicherzustellen, dass MAPI eine Version verwendet, die mit der Version kompatibel ist, die Ihr Adressbuchanbieter verwendet.

  • Instanziieren sie ein Adressbuchanbieterobjekt.

Rufen Sie in dieser Funktion weder MAPIInitialize noch MAPIUninitialize auf.

Die DLL-Einstiegspunktfunktion instanziiert ein Anbieterobjekt und gibt einen Zeiger auf dieses Objekt an die MAPI zurück.