Implementieren der Dienstanbieteranmeldung
Gilt für: Outlook 2013 | Outlook 2016
MAPI ruft eine Methode in Ihrem Anbieterobjekt auf, um den Anmeldevorgang mithilfe des Zeigers zu starten, den Sie von Ihrer Einstiegspunktfunktion zurückgeben. Die Methode variiert je nach Typ Ihres Dienstanbieters wie folgt:
IABProvider::Anmeldung für Adressbuchanbieter
IMSProvider::Anmeldung für Nachrichtenspeicheranbieter
IXPProvider::TransportLogon für Transportanbieter
Führen Sie die folgenden Aufgaben in der von Ihnen implementierten Anmeldemethode aus:
Erhöhen Sie die Verweisanzahl für das Unterstützungsobjekt, das als Eingabeparameter übergeben wird, indem Sie die IUnknown::AddRef-Methode aufrufen.
Rufen Sie die IMAPISupport::OpenProfileSection-Methode des Supportobjekts auf, um auf Ihren Profilabschnitt zuzugreifen.
Rufen Sie die IMAPIProp::SetProps-Methode des Profilabschnitts auf, um die folgenden Eigenschaften festzulegen:
PR_DISPLAY_NAME (PidTagDisplayName)
PR_ENTRYID (PidTagEntryId)
PR_PROVIDER_DISPLAY (PidTagProviderDisplay)
PR_RECORD_KEY (PidTagRecordKey)
Hinweis
Versuchen Sie nicht, die eigenschaften PR_RESOURCE_FLAGS oder PR_PROVIDER_DLL_NAME des Profilabschnitts festzulegen. Zum Zeitpunkt der Anmeldung sind diese Eigenschaften schreibgeschützt.
Überprüfen Sie, ob die Eigenschaften, die Sie für die Konfiguration benötigen, entweder im Profil gespeichert sind oder vom Benutzer verfügbar sind. Weitere Informationen zum Überprüfen Ihrer Konfiguration finden Sie unter Überprüfen der Dienstanbieterkonfiguration.
Rufen Sie die IMAPISupport::SetProviderUID-Methode des Supportobjekts auf, um einen eindeutigen Bezeichner oder MAPIUID zu registrieren, wenn Ihr Anbieter ein Adressbuch- oder Nachrichtenspeicheranbieter ist. Transportanbieter registrieren MAPIUID-Strukturen , wenn MAPI ihre IXPLogon::AddressTypes-Methode aufruft . Weitere Informationen zum Registrieren einer MAPIUID finden Sie unter Registrieren eindeutiger Dienstanbieterbezeichner.
Instanziieren Sie ein Anmeldeobjekt, und geben Sie mit einem der folgenden Werte zurück:
S_OK, um eine erfolgreiche Anmeldung anzugeben.
MAPI_E_UNCONFIGURED, um anzugeben, dass mindestens eine der Konfigurationseigenschaften nicht verfügbar war.
MAPI_E_USER_CANCEL, um anzugeben, dass der Benutzer das Konfigurationsdialogfeld abgebrochen hat, wodurch Konfigurationseigenschaften nicht verfügbar sind.
MAPI_E_FAILONEPROVIDER, um anzugeben, dass Ihr Anbieter nicht konfiguriert werden konnte, aber dass MAPI die Verwendung unabhängig davon zulassen sollte. Anmeldemethoden sollten diesen Wert zurückgeben, um einen nicht schwerwiegenden Fehler zu melden, z. B. wenn der Anbieter ein Kennwort erfordert und den Benutzer nicht dazu auffordern kann, weil die Benutzeroberfläche deaktiviert ist.
Die obige Liste der Aufgaben beschreibt eine Mindestimplementierung für eine Anmeldemethode des Dienstanbieters. Sie können bei Bedarf zusätzliche Funktionen einschließen. Einige Anbieter rufen beispielsweise IMAPISupport::ModifyStatusRow auf, um die status Tabelle in ihrer Anmeldemethode zu aktualisieren.
Hinweis
Um die beste Leistung zum Zeitpunkt der Anmeldung zu erzielen, vermeiden Sie den Aufruf von IMAPISupport::P repareSubmit oder IMAPISupport::SpoolerNotify. Bevor diese Aufrufe abgeschlossen und die Steuerung an Ihre Anmeldemethode zurückgegeben werden können, muss der MAPI-Spooler gestartet werden.