Unterstützen der Nachrichtendienstkonfiguration
Gilt für: Outlook 2013 | Outlook 2016
Gehen Sie wie folgt vor, um die Konfiguration des Nachrichtendiensts zu unterstützen:
Implementieren Sie eine Einstiegspunktfunktion, die dem MSGSERVICEENTRY-Prototyp entspricht. Nachrichtendiensteinstiegspunktfunktionen verwalten den Zugriff auf Konfigurationsdaten und werden unter den folgenden Umständen aufgerufen:
Wenn sich ein Client anmeldet, um Informationen zum Konfigurieren Ihres Nachrichtendiensts abzurufen.
Wenn ein Client eine Konfigurationseigenschaft anzeigen oder ändern möchte.
Obwohl die meisten Nachrichtendienste wie gewünscht Einstiegspunktfunktionen bereitstellen, sind diese Funktionen nicht unbedingt erforderlich. Nachrichtendienste können den Zugriff auf Konfigurationsdaten auf andere Weise ermöglichen. Die Verwendung einer Einstiegspunktfunktion standardisiert und vereinfacht jedoch den Prozess der Konfiguration.
MAPI erwartet, dass alle Einstiegspunktfunktionen des Nachrichtendiensts Eigenschaften speichern und aus den Profilabschnitten abrufen können, die ihrem Nachrichtendienst zugeordnet sind. Sie können diese Funktionalität interaktiv, programmgesteuert oder sowohl interaktiv als auch programmgesteuert unterstützen.
Um die interaktive Konfiguration zu unterstützen, stellen Sie ein Eigenschaftenblatt bereit, das die Eigenschaften anzeigt, die an der Konfiguration Ihres Nachrichtendiensts beteiligt sind. Optional können Sie auch Eigenschaftenblätter für jeden konfigurierbaren Anbieter bereitstellen. Einige Nachrichtendienste beschränken Benutzer auf eine schreibgeschützte Ansicht von Konfigurationseigenschaften. Andere Nachrichtendienste ermöglichen Benutzern das Vornehmen von Änderungen.
Um die programmgesteuerte Konfiguration zu unterstützen, muss Die Einstiegspunktfunktion des Nachrichtendiensts ohne Benutzereingriff funktionieren können. Wenn Ihr Nachrichtendienst vom Profil-Assistenten aufgerufen werden kann, müssen Sie die programmgesteuerte Konfiguration unterstützen. Wenn Ihr Nachrichtendienst die Konfiguration mithilfe des Profil-Assistenten nicht zulässt, können Sie auswählen, ob die programmgesteuerte Konfiguration unterstützt werden soll.
Weitere Informationen zur Unterstützung der Konfiguration in einer Nachrichtendiensteinstiegspunktfunktion finden Sie unter MSGSERVICEENTRY.
Veröffentlichen Sie den Namen Ihrer Einstiegspunktfunktion des Nachrichtendiensts in der Konfigurationsdatei Mapisvc.inf, indem Sie den folgenden Eintrag in den Nachrichtendienstabschnitt einschließen:
PR_SERVICE_ENTRY_NAME=<name of message service>Erstellen Sie ein oder mehrere Eigenschaftenblattdialogfelder zum Anzeigen von Konfigurationsdaten.
Führen Sie die folgenden Aufgaben aus, wenn Sie dem Profil-Assistenten erlauben möchten, Ihren Nachrichtendienst zu konfigurieren:
Implementieren Sie eine Einstiegspunktfunktion, die dem WIZARDENTRY-Prototyp entspricht.
Implementieren Sie eine Standardmäßige Windows-Dialogfeldprozedur, die dem SERVICEWIZARDDLGPROC-Prototyp entspricht.
Verbessern Sie die Einstiegspunktfunktion des Nachrichtendiensts, um auf zusätzliche Ereignisse zu reagieren.