Abrufen von Daten aus Tabellenzeilen
Gilt für: Outlook 2013 | Outlook 2016
Das Abrufen von Zeilen aus einer Tabelle umfasst Folgendes:
Abrufen der Eigenschaftswerte für alle Spalten.
Ändern der aktuellen Position.
Eine der erforderlichen Spalten in den meisten Tabellen ist ein Eintragsbezeichner – die eigenschaft PR_ENTRYID (PidTagEntryId), die zum Öffnen des Objekts verwendet werden kann, das die Zeile darstellt. Dieser Eintragsbezeichner ist in der Regel ein bezeichner für einen kurzfristigen Eintrag, der über die Lebensdauer der Tabelle hinaus nicht beibehalten wird. Es kann sich jedoch um einen langfristigen Bezeichner handeln, wenn der Dienstanbieter, der die Tabelle implementiert, nur einen Typ von Eintragsbezeichner unterstützt.
Clients und Dienstanbieter können einen der folgenden Aufrufe ausführen, um Zeilen abzurufen:
Call | Beschreibung |
---|---|
IMAPITable::QueryRows |
Ruft eine angegebene Anzahl von Zeilen ab, die mit der aktuellen Zeile in Vorwärts- oder Rückwärtsrichtung beginnen. |
HrQueryAllRows |
Ruft alle Zeilen in einer Tabelle ab. |
ITableData::HrQueryRow |
Ruft eine Zeile in einer Tabelle entsprechend dem Wert ihrer Indexspalte ab. PR_INSTANCE_KEY (PidTagInstanceKey) ist in der Regel die Indexspalte für eine Tabelle. |
Wenn eine optionale Eigenschaft als eine der Spalten in einer Tabelle enthalten ist, haben einige der Zeilen möglicherweise gültige Werte für die Spalte, andere nicht. Ob ein gültiger Wert für eine Spalte vorhanden ist, hängt davon ab, ob das Objekt, das die Informationen für die Zeile bereitstellt, die Eigenschaft festlegt. Abhängig von der Implementierung des Objekts kann eine nicht vorhandene Eigenschaft in der Tabelle als PR_NULL (PidTagNull) oder als beliebiger Wert dargestellt werden. Benutzer von Tabellen müssen darauf achten, zwischen Eigenschaften zu unterscheiden, die nicht vorhanden sind und über bedeutungslose Werte und Eigenschaften verfügen, die vorhanden sind und gültige Werte aufweisen.