Propriété canonique PidTagSearchKey

Article
03/15/2024

S’applique à : Outlook 2013 | Outlook 2016

Contient une clé binaire comparable qui identifie les objets corrélés pour une recherche.

Propriété	Valeur
Propriétés associées :	PR_SEARCH_KEY
Identificateur :	0x300B
Type de données :	PT_BINARY
Domaine :	Propriétés d’ID

Remarques

Cette propriété fournit une trace pour les objets associés, tels que les copies de messages, et facilite la recherche d’occurrences indésirables, telles que les destinataires en double.

MAPI utilise des règles spécifiques pour construire des clés de recherche pour les destinataires des messages. La clé de recherche est formée en concaténant le type d’adresse (en majuscules), le caractère deux-points « : », l’adresse e-mail sous forme canonique et le caractère null de fin. La forme canonique signifie ici que les adresses respectant la casse apparaissent dans la casse correcte et que les adresses qui ne respectent pas la casse sont converties en majuscules. Cela est important pour préserver les corrélations entre les messages.

Pour les objets message, cette propriété est disponible via la méthode IMAPIProp ::GetProps immédiatement après la création du message. Pour les autres objets, il est disponible après le premier appel à la méthode IMAPIProp ::SaveChanges . Étant donné que cette propriété est modifiable, il n’est pas fiable de l’obtenir via GetProps jusqu’à ce qu’un appel SaveChanges ait commité des valeurs définies ou modifiées par la méthode IMAPIProp ::SetProps .

Pour les profils, MAPI fournit également une section de profil codée en dur nommée MUID_PROFILE_INSTANCE, avec cette propriété comme propriété unique. Cette clé est garantie d’être unique parmi tous les profils jamais créés et peut être plus fiable que la propriété PR_PROFILE_NAME (PidTagProfileName), qui peut, par exemple, être supprimée et recréée avec le même nom.

Le tableau suivant récapitule les différences importantes entre les PR_ENTRYID (PidTagEntryId), les PR_RECORD_KEY (PidTagRecordKey) et cette propriété.

Caractéristique	PR_ENTRYID	PR_RECORD_KEY	PR_SEARCH_KEY
Obligatoire sur les objets de pièce jointe	Non	Oui	Non
Obligatoire sur les objets de dossier	Oui	Oui	Non
Obligatoire sur les objets de la banque de messages	Oui	Oui	Non
Obligatoire sur les objets status	Oui	Non	Non
Créatable par client	Non	Non	Oui
Disponible avant SaveChanges	Dépend de l’implémentation du fournisseur	Dépend de l’implémentation du fournisseur	Pour les messages, Oui. Pour d’autres, cela dépend de l’implémentation du fournisseur.
Modification dans une opération de copie	Oui	Oui	Non
Modifiable par le client après une copie	Non	Non	Oui
Unique dans ...	Monde entier	Instance fournisseur	Monde entier
Binaire comparable (comme avec memcmp)	Non : utilisez IMAPISupport ::CompareEntryIDs	Oui	Oui