Überprüfen der Dienstanbieterkonfiguration
Gilt für: Outlook 2013 | Outlook 2016
Ihre Anmeldemethode (IABProvider::Logon, IMSProvider::Logon oder IXPProvider::TransportLogon) muss die Konfiguration Ihres Anbieters überprüfen. Dies umfasst die Überprüfung, ob alle eigenschaften, die für den vollständigen Betrieb erforderlich sind, richtig festgelegt sind. Jeder Anbieter erfordert eine andere Anzahl von Eigenschaften. Die Konfiguration hängt von Ihrem Anbieter und dem Grad der Benutzerinteraktion ab, den Sie zulassen. Einige Dienstanbieter behalten alle erforderlichen Eigenschaften im Profil bei.
Andere Dienstanbieter behalten einen partiellen Satz von Eigenschaften im Profil bei und fordern den Benutzer zur Eingabe fehlender Werte auf. Andere Anbieter speichern eigenschaften überhaupt nicht im Profil und verlassen sich darauf, dass der Benutzer alle für die Konfiguration erforderlichen Informationen angibt.
So rufen Sie im Profil gespeicherte Eigenschaften ab
Rufen Sie IMAPISupport::OpenProfileSection auf, und übergeben Sie die MAPIUID Ihres Anbieters als Eingabeparameter.
Rufen Sie die METHODEN IMAPIProp::GetProps oder IMAPIProp::GetPropList des Profilabschnitts auf, um einzelne Eigenschaften oder eine Eigenschaftenliste abzurufen.
So legen Sie Eigenschaften aus Benutzerinformationen fest
Zeigt ein Eigenschaftenblatt an, wenn MAPI kein Flag festgelegt hat, das die Anzeige verhindert. Die folgenden Flags geben an, dass eine Benutzeroberfläche nicht angezeigt werden kann.
| Wert | Dienstleister |
|---|---|
| AB_NO_DIALOG |
Adressbuchanbieter |
| LOGON_NO_DIALOG |
Transportanbieter |
| MDB_NO_DIALOG |
Nachrichtenspeicheranbieter |
Wenn Ihr Anbieter nicht alle Konfigurationseigenschaften im Profil speichert, was eine Benutzerinteraktion erfordert, und MAPI eines der Dialogfeldunterdrückungsflags an Ihre Anmeldemethode übergibt, geben Sie MAPI_E_UNCONFIGURED zurück. Gibt auch diesen Fehler zurück, wenn das Flag für die Dialogunterdrückung nicht festgelegt ist, der Benutzer aber nicht alle erforderlichen Informationen angibt.
Wenn ihr Dienstanbieter seine Anmeldemethode mit MAPI_E_UNCONFIGURED fehlschlägt, ruft MAPI ihre Einstiegspunktfunktion erneut auf. Wenn die Informationen beim zweiten Aufruf nicht gefunden werden können, wird die Sitzung möglicherweise beendet, je nachdem, wie wichtig Ihr Dienstanbieter ist.
Die folgende Abbildung zeigt die Logik, die für die Konfiguration in Ihrer Anmeldemethode des Dienstanbieters erforderlich ist.
Flussdiagramm für Konfigurationsüberprüfung
