Freigeben über


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 Dienstanbietern bei der Tabellenwartung zu helfen. Zum Abrufen eines Tabellendatenobjekts 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 anhand 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. Daher ist sie für die Verwendung mit sehr großen Tabellen nicht geeignet. Umfangreiche Einschränkungen und komplexe Vorgänge wie die Kategorisierung werden nicht unterstützt.

Tabellendatenobjekte identifizieren Zeilen mithilfe einer Indexspalte, einer Eigenschaft, die für jede Zeile garantiert einen eindeutigen Wert 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 eine einzelne Benachrichtigung, unabhängig von der Anzahl der Zeilen, die von einer Änderung oder Löschung betroffen sind. Wenn eine Zielzeile in einem Vorgang nicht vorhanden ist, wird eine Zeile hinzugefügt.

Siehe auch

MAPI-Schnittstellen