IProfSect : IMAPIProp
S’applique à : Outlook 2013 | Outlook 2016
Fonctionne avec les propriétés des objets de section de profil.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapix.h |
| Exposé par : |
Objets de section de profil |
| Implémenté par : |
MAPI |
| Appelé par : |
Applications clientes et fournisseurs de services |
| Identificateur d’interface : |
IID_IProfSect |
| Type de pointeur : |
LPPROFSECT |
| Modèle de transaction : |
Non traduit |
Ordre de la table de Vtable
Cette interface n’a pas de méthodes uniques.
| Propriétés requises | Access |
|---|---|
|
PR_OBJECT_TYPE (PidTagObjectType) |
Lecture seule |
|
PR_PROFILE_NAME (PidTagProfileName) |
Lecture seule |
Remarques pour les appelants
L’interface IProfSect n’a pas de méthodes uniques, mais vous pouvez appeler les méthodes IMAPIProp de la section de profil. Il existe quelques différences entre l’implémentation IProfSect et d’autres implémentations de IMAPIProp :
IProfSect ne prend pas en charge un modèle de transaction.
IProfSect ne prend pas en charge les propriétés nommées.
IProfSect réserve la plage d’identificateurs 0x67F0 à 0x67ff pour les propriétés sécurisées.
Le fait de ne pas prendre en charge un modèle de transaction signifie que toutes les modifications apportées à une section de profil suite aux appels aux méthodes IMAPIProp ::CopyProps et IMAPIProp ::CopyTo se produisent immédiatement. Les appels à la méthode IMAPIProp ::SaveChanges réussissent, mais n’enregistrent pas réellement les modifications.
Pour être protégés contre les modifications qui se produisent prématurément, les fournisseurs de services doivent effectuer des copies de leurs sections de profil qui sont affichées aux utilisateurs via des feuilles de propriétés. Les feuilles de propriétés doivent fonctionner avec la copie, au lieu de la section de profil réel. Lorsque l’utilisateur clique sur le bouton OK pour vérifier que les modifications sont exactes, les modifications peuvent être enregistrées dans la section du profil réel.
Pour implémenter une feuille de propriétés à l’aide d’une section de profil copiée, procédez comme suit :
Ouvrez la section profil en appelant la méthode IMAPISupport ::OpenProfileSection ou IProviderAdmin ::OpenProfileSection .
Appelez la fonction CreateIProp pour récupérer un objet de données de propriété, un objet qui prend en charge l’interface IPropData .
Appelez la méthode IMAPIProp ::CopyTo de la section de profil pour copier les propriétés qui apparaîtront dans la feuille de propriétés de la section profil vers l’objet de données de propriété.
Appelez la méthode IMAPISupport ::D oConfigPropSheet pour demander que le fournisseur de services affiche une feuille de propriétés et passe un pointeur vers l’objet de données de propriété dans le paramètre lpConfigData .
Lorsque l’utilisateur enregistre les modifications apportées aux propriétés de configuration dans la feuille de propriétés, appelez la méthode IMAPIProp ::CopyTo pour copier les propriétés de l’objet de données de propriété dans la section profil.
Contrairement aux autres objets, les sections de profil ne prennent pas en charge les propriétés nommées. Les méthodes IMAPIProp ::GetIDsFromNames et IMAPIProp ::GetNamesFromIDs retournent MAPI_E_NO_SUPPORT si elles sont appelées sur un objet de section de profil. Si vous utilisez la méthode IMAPIProp ::SetProps pour définir des identificateurs de propriété dans la plage ci-dessus 0x8000, le type de propriété PT_ERROR est retourné.
Les sections de profil réservent la plage d’identificateurs 0x67F0 à 0x67FF pour les propriétés sécurisées. Les fournisseurs de services peuvent utiliser cette plage pour stocker des mots de passe et d’autres informations d’identification spécifiques au fournisseur. Les propriétés de cette plage ne sont pas retournées dans la liste complète des propriétés lorsque NULL est transmis dans le paramètre lpPropTag de la méthode IMAPIProp ::GetProps , ni dans le paramètre lppPropTagArray de la méthode IMAPIProp ::GetPropList . Les propriétés sécurisées doivent être demandées spécifiquement par leurs identificateurs.
MAPI fournit une section de profil avec la constante codée en dur MUID_PROFILE_INSTANCE comme identificateur et PR_SEARCH_KEY (PidTagSearchKey) comme propriété unique. MAPI garantit que la valeur de propriété PR_SEARCH_KEY sera unique parmi tous les profils créés. Utilisez PR_SEARCH_KEY au lieu de PR_PROFILE_NAME lorsque l’unicité est importante, car il est possible qu’un profil supprimé soit suivi d’un autre profil portant le même nom.
Pour plus d’informations sur l’utilisation des sections de profil, consultez Administration des profils et des services de message.