Identificateurs d’entrée MAPI
S’applique à : Outlook 2013 | Outlook 2016
Les identificateurs d’entrée sont des éléments de données binaires stockés dans une structure ENTRYID qui sont utilisés pour identifier et ouvrir un objet MAPI de manière unique. La plupart des objets MAPI ont des identificateurs d’entrée. Les identificateurs d’entrée pour les objets sont analogues aux noms de fichiers pour les fichiers. Toutefois, ils ne sont pas transmettables et ne peuvent pas être utilisés sur des systèmes autres que le système sur lequel ils proviennent.
Identificateurs d’entrée
Les fournisseurs de magasins de messages attribuent des identificateurs d’entrée aux magasins de messages, aux dossiers et aux messages ; Les fournisseurs de carnets d’adresses les attribuent aux conteneurs de carnets d’adresses, aux listes de distribution et aux utilisateurs de messagerie. Les identificateurs d’entrée sont également utilisés pour ouvrir un objet représenté par une ligne dans une table, par exemple un objet status dans la table status. Les objets stockent leurs identificateurs d’entrée dans leur propriété PR_ENTRYID (PidTagEntryId).
Alors que les fournisseurs de services créent, attribuent et examinent des identificateurs d’entrée, les applications clientes les utilisent uniquement comme outils pour ouvrir des objets. Pour les clients, les identificateurs d’entrée sont des éléments opaques de données binaires et n’ont rien à voir avec le système de messagerie sous-jacent.
Les clients appellent la méthode IMAPIProp ::GetProps d’un objet pour récupérer sa propriété PR_ENTRYID ou la méthode IMAPITable ::QueryColumns d’une table pour récupérer la colonne qui contient la propriété PR_ENTRYID .
Les identificateurs d’entrée sont passés en tant que paramètres aux méthodes OpenEntry et CompareEntryIDs . Plusieurs objets MAPI implémentent les méthodes OpenEntry et CompareEntryIDs . Avec OpenEntry, les clients peuvent ouvrir un objet. Avec CompareEntryIDs, les clients peuvent comparer deux identificateurs d’entrée pour déterminer s’ils font référence au même objet. Étant donné que les identificateurs d’entrée ne sont pas nécessairement binaires comparables, les clients doivent les comparer à l’aide de la méthode CompareEntryIDs .
Les clients doivent toujours passer des identificateurs d’entrée naturellement alignés dans leurs appels aux fournisseurs de services, car même si les fournisseurs de services doivent gérer les identificateurs d’entrée qui sont alignés arbitrairement, ce n’est pas toujours le cas. Une adresse mémoire naturellement alignée permet à l’ordinateur d’accéder à tous les types de données qu’il prend en charge à cette adresse sans générer d’erreur d’alignement. Le facteur d’alignement naturel est généralement le même facteur d’alignement que celui utilisé par l’allocateur de mémoire système et est généralement de 8 octets.
Les identificateurs d’entrée sont de deux types : à court terme et à long terme. Les identificateurs d’entrée à court terme sont plus rapides à construire, mais leur unicité n’est garantie que pendant la durée de la session active sur la station de travail actuelle. Les identificateurs d’entrée à long terme ont une durée de vie plus longue. Les identificateurs d’entrée à court terme sont principalement utilisés pour les lignes dans les tables et les entrées dans les boîtes de dialogue, tandis que les identificateurs d’entrée à long terme sont utilisés pour de nombreux objets tels que les messages, les dossiers et les listes de distribution.