IMAPIStatus::SettingsDialog
Gilt für: Outlook 2013 | Outlook 2016
Zeigt ein Eigenschaftenblatt an, das es dem Benutzer ermöglicht, die Konfiguration eines Dienstanbieters zu ändern. Diese Methode wird in status Objekten, die MAPI implementiert, nicht unterstützt.
HRESULT SettingsDialog(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parameter
ulUIParam
[in] Ein Handle für das übergeordnete Fenster des Konfigurationseigenschaftenblatts.
ulFlags
[in] Eine Bitmaske von Flags, die die Anzeige des Eigenschaftenblatts steuert. Das folgende Flag kann festgelegt werden:
UI_READONLY
Schlägt vor, dass der Anbieter Benutzern nicht das Ändern von Konfigurationseigenschaften ermöglichen sollte. Diese Kennzeichnung ist nur ein Vorschlag; sie kann ignoriert werden.
Rückgabewert
S_OK
Das Konfigurationseigenschaftenblatt wurde erfolgreich angezeigt.
MAPI_E_NO_SUPPORT
Das status-Objekt unterstützt diese Methode nicht, wie durch das Fehlen des STATUS_SETTINGS_DIALOG-Flags in der eigenschaft PR_RESOURCE_METHODS (PidTagResourceMethods) angegeben.
Hinweise
Die IMAPIStatus::SettingsDialog-Methode zeigt ein Konfigurationseigenschaftenblatt an. Alle Dienstanbieter sollten die SettingsDialog-Methode unterstützen, aber sie ist nicht erforderlich. Dienstanbieter können eigene Eigenschaftenblätter implementieren oder die in der IMAPISupport::D oConfigPropsheet-Methode des Supportobjekts bereitgestellte Implementierung verwenden. DoConfigPropsheet erstellt ein Eigenschaftenblatt mit Lese-/Schreibzugriff.
Hinweise für Implementierer
Wenn ein Remotetransportanbieter über Einstellungen verfügt, sollte er die folgenden Aktionen ausführen:
Öffnen Sie den Profilabschnitt des Transportanbieters.
Rufen Sie die Eigenschafteneinstellungen des Transportanbieters aus dem Profil ab.
Zeigen Sie die Eigenschafteneinstellungen in einem Dialogfeld an.
Wenn das Dialogfeld die Bearbeitung der Eigenschafteneinstellungen zulässt, überprüfen Sie, ob die neuen Einstellungen gültig sind, und speichern Sie sie wieder im Profilabschnitt des Transportanbieters.
Gibt S_OK oder alle Fehlerwerte zurück, die während der vorherigen Schritte zurückgegeben wurden.
Hinweise für Aufrufer
Sie können das über SettingsDialog angezeigte Eigenschaftenblatt verwenden, um eine Vielzahl von Aufgaben auszuführen, z. B. die folgenden:
Geben Sie einen Standardnachrichtenspeicher an.
Geben Sie einen Transportauftrag an.
Geben Sie einen Standardadressbuchcontainer für das Durchsuchen an.
Geben Sie eine Suchreihenfolge zum Auflösen von mehrdeutigen Namen an.
Geben Sie ein persönliches Standardadressbuch an.
Dienstanbieter können Je nach Eigenschaft Eigenschaftenblätter implementieren, die lese-/schreibgeschützt oder eine Mischung aus Berechtigungen sind. Dienstanbieter können unterschiedliche Berechtigungen für einzelne Eigenschaften implementieren, indem sie Eigenschaftseinschränkungen festlegen. Der Standardmodus für Eigenschaftenblätter ist Lese-/Schreibzugriff. Sie können schreibgeschützte Eigenschaftenblätter anfordern, indem Sie das UI_READONLY-Flag in Ihren Aufrufen von SettingsDialog festlegen. Dienstanbieter, die schreibgeschützte Eigenschaftenblätter implementieren können, können dies tun. Da jedoch einige Dienstanbieter den Standardmodus nicht außer Kraft setzen können, müssen Sie darauf vorbereitet sein, Eigenschaftenblätter beider Typen zu behandeln.
Da an diesem Vorgang immer eine Benutzeroberfläche beteiligt ist, sollten nur interaktive Clients SettingsDialog aufrufen.
Siehe auch
IMAPISupport::DoConfigPropsheet