ITableData : IUnknown
S’applique à : Outlook 2013 | Outlook 2016
Fournit des méthodes utilitaires pour l’utilisation des tables. MAPI fournit des objets de données de table ou des objets qui implémentent ITableData pour aider les fournisseurs de services à effectuer la maintenance des tables. Pour obtenir un objet de données de table, les fournisseurs de services appellent la fonction CreateTable .
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapiutil.h |
| Exposé par : |
Objets de données de table |
| Implémenté par : |
MAPI |
| Appelé par : |
Fournisseurs de services |
| Identificateur d’interface : |
IID_IMAPITableData |
| Type de pointeur : |
LPTABLEDATA |
Ordre de la table de Vtable
| Member | Description |
|---|---|
|
HrGetView |
Crée une vue de table, renvoyant un pointeur vers une implémentation IMAPITable . |
|
HrModifyRow |
Insère une nouvelle ligne de tableau, éventuellement en remplaçant une ligne existante. |
|
HrDeleteRow |
Supprime une ligne de tableau. |
|
HrQueryRow |
Récupère une ligne de table. |
|
HrEnumRow |
Récupère une ligne en fonction de sa position dans la table. |
|
HrNotify |
Envoie une notification pour une ligne de table. |
|
HrInsertRow |
Insère une ligne de tableau. |
|
HrModifyRows |
Insère plusieurs lignes de table, éventuellement en remplaçant les lignes existantes. |
|
HrDeleteRows |
Supprime plusieurs lignes de table. |
Remarques
L’implémentation MAPI d’ITableData fonctionne avec les tables en conservant toutes les données et toutes les restrictions associées en mémoire, ce qui la rend impropre à une utilisation avec des tables très volumineuses. Les restrictions volumineuses et les opérations complexes telles que la catégorisation ne sont pas prises en charge.
Les objets de données de table identifient les lignes à l’aide d’une colonne d’index, propriété qui a la garantie d’avoir une valeur unique pour chaque ligne. La plupart des fournisseurs de services utilisent la propriété PR_INSTANCE_KEY (PidTagInstanceKey) comme colonne d’index. Les propriétés qui ont plusieurs valeurs ne peuvent pas être utilisées comme colonne d’index.
Les objets de données de table génèrent une seule notification, quel que soit le nombre de lignes affectées par une modification ou une suppression. Si aucune ligne cible n’existe dans une opération, une ligne est ajoutée.