Récupération de données à partir de lignes de table
S’applique à : Outlook 2013 | Outlook 2016
La récupération de lignes à partir d’une table implique :
Obtention des valeurs de propriété pour toutes les colonnes.
Modification de la position actuelle.
L’une des colonnes requises dans la plupart des tables est un identificateur d’entrée (propriété PR_ENTRYID (PidTagEntryId) qui peut être utilisé pour ouvrir l’objet qui représente la ligne. Cet identificateur d’entrée est généralement un identificateur d’entrée à court terme, qui ne persiste pas au-delà de la durée de vie de la table. Toutefois, il peut s’agir d’un identificateur à long terme si le fournisseur de services implémentant la table ne prend en charge qu’un seul type d’identificateur d’entrée.
Les clients et les fournisseurs de services peuvent effectuer l’un des appels suivants pour récupérer des lignes :
Appel | Description |
---|---|
IMAPITable::QueryRows |
Récupère un nombre spécifié de lignes commençant par la ligne actuelle dans un sens avant ou vers l’arrière. |
HrQueryAllRows |
Récupère toutes les lignes d’une table. |
ITableData::HrQueryRow |
Récupère une ligne dans une table en fonction de la valeur de sa colonne d’index. PR_INSTANCE_KEY (PidTagInstanceKey) est généralement la colonne d’index d’une table. |
Lorsqu’une propriété facultative est incluse dans l’une des colonnes d’une table, certaines lignes peuvent avoir des valeurs valides pour la colonne, tandis que d’autres ne le sont pas. L’existence ou non d’une valeur valide pour une colonne varie selon que l’objet fournissant les informations de la ligne définit la propriété . Selon l’implémentation de l’objet, une propriété inexistante peut être représentée dans la table en tant que PR_NULL (PidTagNull) ou une valeur arbitraire. Les utilisateurs de tables doivent faire la distinction entre les propriétés qui sont inexistantes et qui ont des valeurs sans signification et les propriétés qui existent et ont des valeurs valides.