Propriété canonique PidTagSubjectPrefix

Article
04/04/2023

S’applique à : Outlook 2013 | Outlook 2016

Contient un préfixe d’objet qui indique généralement une action sur un message, telle que « FW : » pour le transfert.

Propriété	Valeur
Propriétés associées :	PR_SUBJECT_PREFIX, PR_SUBJECT_PREFIX_A PR_SUBJECT_PREFIX_W
Identificateur :	0x003D
Type de données :	PT_STRING8, PT_UNICODE
Domaine :	Messagerie générale

Remarques

Ces propriétés sont recommandées sur tous les objets de message.

Le préfixe d’objet se compose d’un ou de plusieurs caractères alphanumériques, suivis de deux-points et d’un espace (qui font partie du préfixe). Il ne doit pas contenir de caractères nonphanumériques avant le signe deux-points. L’absence d’un préfixe peut être représentée par une chaîne vide ou par cette propriété qui n’est pas définie.

Si ces propriétés sont définies explicitement, la chaîne peut être de n’importe quelle longueur et utiliser des caractères alphanumériques, mais elle doit correspondre à une sous-chaîne au début de la propriété PR_SUBJECT (PidTagSubject). Si ces propriétés ne sont pas définies par l’expéditeur et doivent être calculées, leur contenu est plus restreint. La règle de calcul du préfixe est que PR_SUBJECT doit commencer par une, deux ou trois lettres (alphabétique uniquement) suivies d’un signe deux-points et d’un espace. Si une telle sous-chaîne est trouvée au début de PR_SUBJECT, elle devient alors la chaîne de ces propriétés (et reste également au début de PR_SUBJECT). Dans le cas contraire, ces propriétés restent non définies.

Ces propriétés et PR_NORMALIZED_SUBJECT (PidTagNormalizedSubject) doivent être calculées dans le cadre de l’implémentation IMAPIProp ::SaveChanges . Un client ne doit pas inviter IMAPIProp ::GetProps à entrer ses valeurs tant qu’ils n’ont pas été validées par un appel IMAPIProp ::SaveChanges .

Les propriétés de l’objet sont généralement de petites chaînes de moins de 256 caractères, et un fournisseur de magasin de messages n’est pas obligé de prendre en charge l’interface OLE IStream sur celles-ci. Un client doit toujours essayer d’accéder par le biais de l’interface IMAPIProp en premier, et recourir à IStream uniquement si MAPI_E_NOT_ENOUGH_MEMORY est retourné.