Propriété canonique PidTagRecordKey
S’applique à : Outlook 2013 | Outlook 2016
Contient un identificateur binaire unique comparable pour un objet spécifique.
Propriété | Valeur |
---|---|
Propriétés associées : |
PR_RECORD_KEY |
Identificateur : |
0x0FF9 |
Type de données : |
PT_BINARY |
Domaine : |
Propriétés d’ID |
Remarques
Cette propriété facilite la localisation des références à un objet, telles que la recherche de sa ligne dans une table de contenu. Cette propriété ne peut pas être utilisée pour ouvrir un objet ; utilisez l’identificateur d’entrée à cet effet.
Un sous-objet de pièce jointe doit être identifié de manière unique dans un message par cette propriété. Cet identificateur est la seule caractéristique de pièce jointe garantie pour rester le même après la fermeture et la réouverture du message. Le fournisseur de magasins doit conserver cette propriété entre les sessions pour garantir cette garantie.
Pour les dossiers, cette propriété contient une clé utilisée dans la table de hiérarchie de dossiers. Il s’agit généralement de la même valeur que celle fournie par la propriété PR_ENTRYID (PidTagEntryId).
Pour les magasins de messages, cette propriété est identique à la propriété PR_STORE_RECORD_KEY (PidTagStoreRecordKey).
Dans un objet de magasin de messages, cette propriété doit être unique parmi tous les fournisseurs de magasins. Pour ce faire, vous pouvez combiner la valeur de la propriété PR_MDB_PROVIDER (PidTagStoreProvider) pour le magasin (propre à ce type de fournisseur) avec une structure GUID ou une autre valeur propre à la banque de messages spécifique.
Cette propriété est toujours disponible via la méthode IMAPIProp ::GetProps après le premier appel à la méthode IMAPIProp ::SaveChanges . Certains fournisseurs peuvent le rendre disponible immédiatement après l’instanciation.
Un client ou un fournisseur de services peut comparer les valeurs de cette propriété à l’aide de memcmp. Cela n’est pas possible pour les valeurs d’identificateur d’entrée. Toutefois, cette propriété est garantie d’être unique au sein du même magasin de messages ou conteneur de carnet d’adresses ; deux objets de conteneurs différents peuvent avoir la même valeur de cette propriété.
Une distinction entre les clés d’enregistrement et de recherche est que la clé d’enregistrement est spécifique à l’objet, tandis que la clé de recherche peut être copiée vers d’autres objets. Par exemple, deux copies de l’objet peuvent avoir la même valeur PR_SEARCH_KEY (PidTagSearchKey), mais doivent avoir des valeurs différentes pour cette propriété.
Le tableau suivant récapitule les différences importantes entre PR_ENTRYID, PR_SEARCH_KEY (PidTagSearchKey) 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 un appel à SaveChanges |
Peut-être |
Peut-être |
Messages Oui Autres peut-être |
Modification dans une opération de copie |
Oui |
Oui |
Non |
Modifiable par un 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 |
Ressources connexes
Spécifications du protocole
Fournit des références aux spécifications de protocole Exchange Server associées.
Gère les objets de message et de pièce jointe.
Spécifie les propriétés et les opérations pour les listes d’utilisateurs, de contacts, de groupes et de ressources.
Fichiers d’en-tête
Mapidefs.h
Fournit des définitions de type de données.
Mapitags.h
Contient des définitions de propriétés répertoriées en tant que noms alternatifs.