Propriété canonique PidTagInstanceKey
S’applique à : Outlook 2013 | Outlook 2016
Contient une valeur qui identifie de façon unique une ligne dans une table.
| Propriété | Valeur |
|---|---|
| Propriétés associées : |
PR_INSTANCE_KEY |
| Identificateur : |
0x0FF6 |
| Type de données : |
PT_BINARY |
| Domaine : |
Tableau |
Remarques
Cette propriété est une valeur binaire qui identifie de façon unique une ligne dans une vue de table. Il s’agit d’une colonne obligatoire dans la plupart des tables. Si une ligne est incluse dans deux vues, il existe deux clés instance différentes. La clé instance d’une ligne peut différer chaque fois que la table est ouverte, mais reste constante tant que la table est ouverte. Les lignes ajoutées pendant l’utilisation d’une table ne réutilisent pas une clé instance précédemment utilisée.
Utilisez les propriétés PR_ENTRYID (PidTagEntryId) ou PR_RECORD_KEY (PidTagRecordKey) pour mettre en corrélation toutes les lignes d’une extension. Utilisez PR_INSTANCE_KEY pour localiser un instance particulier dans l’extension.
Lorsqu’une propriété à plusieurs valeurs est développée dans une table, une ligne est créée pour chaque instance de l’extension, c’est-à-dire pour chaque valeur de cette propriété. Chaque ligne a une valeur unique pour la propriété PR_INSTANCE_KEY , tandis que toutes les autres colonnes conservent leurs valeurs d’origine tout au long de l’expansion.
Dans un type catégorisé d’une table, les lignes ne correspondant pas aux données réelles peuvent être ajoutées au résultat du tri. Chaque ligne de ce type, comme toutes les lignes de toutes les tables, a sa propre clé instance unique.
PR_INSTANCE_KEY est également utilisé dans les notifications d’événements de table. Les membres propIndex et propPrior de la structure TABLE_NOTIFICATION sont des structures SPropValue contenant PR_INSTANCE_KEY valeurs. Le membre propIndex indique la ligne qui a été ajoutée ou modifiée. Le membre propPrior indique la ligne avant la ligne ajoutée ou modifiée (PR_NULL indique une modification apportée à la première ligne).
Cette valeur n’est pas copiée dans le cadre de la table d’affichage.
PR_INSTANCE_KEY est une structure MAPIUID . Toutes les clés instance peuvent être comparées directement en tant que valeurs binaires.
Ressources connexes
Spécifications du protocole
Fournit des références aux spécifications de protocole Exchange Server associées.
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.