IMAPIStatus::SettingsDialog
S’applique à : Outlook 2013 | Outlook 2016
Affiche une feuille de propriétés qui permet à l’utilisateur de modifier la configuration d’un fournisseur de services Cette méthode n’est pas prise en charge dans status objets implémentés par MAPI.
HRESULT SettingsDialog(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Paramètres
ulUIParam
[in] Handle de la fenêtre parente de la feuille de propriétés de configuration.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle l’affichage de la feuille de propriétés. L’indicateur suivant peut être défini :
UI_READONLY
Suggère que le fournisseur ne doit pas autoriser les utilisateurs à modifier les propriétés de configuration. Cet indicateur n’est qu’une suggestion ; il peut être ignoré.
Valeur renvoyée
S_OK
La feuille de propriétés de configuration s’est affichée avec succès.
MAPI_E_NO_SUPPORT
L’objet status ne prend pas en charge cette méthode, comme l’indique l’absence de l’indicateur STATUS_SETTINGS_DIALOG dans la propriété PR_RESOURCE_METHODS (PidTagResourceMethods).
Remarques
La méthode IMAPIStatus ::SettingsDialog affiche une feuille de propriétés de configuration. Tous les fournisseurs de services doivent prendre en charge la méthode SettingsDialog , mais ce n’est pas obligatoire. Les fournisseurs de services peuvent implémenter leurs propres feuilles de propriétés ou utiliser l’implémentation fournie dans la méthode IMAPISupport ::D oConfigPropsheet de l’objet de support. DoConfigPropsheet génère une feuille de propriétés en lecture/écriture.
Remarques pour les responsables de l’implémentation
Si un fournisseur de transport distant a des paramètres, il doit effectuer les opérations suivantes :
Ouvrez la section profil du fournisseur de transport.
Obtenez les paramètres de propriété du fournisseur de transport à partir du profil.
Afficher les paramètres de propriété dans une boîte de dialogue.
Si la boîte de dialogue permet de modifier les paramètres de propriété, case activée que les nouveaux paramètres sont valides et les stocker à nouveau dans la section du profil du fournisseur de transport.
Retourne S_OK ou toutes les valeurs d’erreur retournées au cours des étapes précédentes.
Remarques pour les appelants
Vous pouvez utiliser la feuille de propriétés affichée via ParamètresDialog pour effectuer diverses tâches, telles que les suivantes :
Spécifiez une banque de messages par défaut.
Spécifiez un ordre de transport.
Spécifiez un conteneur de carnet d’adresses par défaut pour la navigation.
Spécifiez un ordre de recherche pour résoudre les noms ambigus.
Spécifiez un carnet d’adresses personnel par défaut.
Les fournisseurs de services peuvent implémenter des feuilles de propriétés en lecture/écriture, en lecture seule ou une combinaison d’autorisations, en fonction de la propriété. Les fournisseurs de services peuvent implémenter différentes autorisations sur des propriétés individuelles en définissant des restrictions de propriété. Le mode par défaut pour les feuilles de propriétés est lecture/écriture. Vous pouvez demander des feuilles de propriétés en lecture seule en définissant l’indicateur UI_READONLY dans vos appels à ParamètresDialog. Les fournisseurs de services capables d’implémenter des feuilles de propriétés en lecture seule peuvent le faire. Toutefois, étant donné que certains fournisseurs de services ne peuvent pas remplacer le mode par défaut, vous devez être prêt à gérer les feuilles de propriétés de l’un ou l’autre type.
Étant donné qu’une interface utilisateur est toujours impliquée dans cette opération, seuls les clients interactifs doivent appeler SettingsDialog.
Voir aussi
IMAPISupport::DoConfigPropsheet