ITableData : IUnknown
Gilt für: Outlook 2013 | Outlook 2016
Stellt Hilfsmethoden für die Arbeit mit Tabellen bereit. MAPI stellt Tabellendatenobjekte oder -objekte bereit, die ITableData implementieren, um Dienstanbieter bei der Tabellenwartung zu unterstützen. Um ein Tabellendatenobjekt abzurufen, rufen Dienstanbieter die CreateTable-Funktion auf.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapiutil.h |
| Verf�gbar gemacht von: |
Tabellendatenobjekte |
| Implementiert von: |
MAPI |
| Aufgerufen von: |
Dienstanbieter |
| Schnittstellenbezeichner: |
IID_IMAPITableData |
| Zeigertyp: |
LPTABLEDATA |
Vtable-Reihenfolge
| Member | Beschreibung |
|---|---|
| HrGetView |
Erstellt eine Tabellenansicht und gibt einen Zeiger auf eine IMAPITable-Implementierung zurück. |
| HrModifyRow |
Fügt eine neue Tabellenzeile ein und ersetzt möglicherweise eine vorhandene Zeile. |
| HrDeleteRow |
Löscht eine Tabellenzeile. |
| HrQueryRow |
Ruft eine Tabellenzeile ab. |
| HrEnumRow |
Ruft eine Zeile basierend auf ihrer Position in der Tabelle ab. |
| HrNotify |
Sendet eine Benachrichtigung für eine Tabellenzeile. |
| HrInsertRow |
Fügt eine Tabellenzeile ein. |
| HrModifyRows |
Fügt mehrere Tabellenzeilen ein und ersetzt möglicherweise vorhandene Zeilen. |
| HrDeleteRows |
Löscht mehrere Tabellenzeilen. |
Hinweise
Die MAPI-Implementierung von ITableData funktioniert mit Tabellen, indem alle Daten und alle zugehörigen Einschränkungen im Arbeitsspeicher enthalten sind, sodass sie für die Verwendung mit sehr großen Tabellen nicht geeignet sind. Große Einschränkungen und komplexe Vorgänge wie die Kategorisierung werden nicht unterstützt.
Tabellendatenobjekte identifizieren Zeilen mithilfe einer Indexspalte, einer Eigenschaft, die garantiert einen eindeutigen Wert für jede Zeile hat. Die meisten Dienstanbieter verwenden die Eigenschaft PR_INSTANCE_KEY (PidTagInstanceKey) als Indexspalte. Eigenschaften mit mehreren Werten können nicht als Indexspalte verwendet werden.
Tabellendatenobjekte generieren unabhängig von der Anzahl der von einer Änderung oder Löschung betroffenen Zeilen eine einzelne Benachrichtigung. Wenn eine Zielzeile in einem Vorgang nicht vorhanden ist, wird eine Zeile hinzugefügt.