SRowSet
Gilt für: Outlook 2013 | Outlook 2016
Enthält ein Array von SRow-Strukturen . Jede SRow-Struktur beschreibt eine Zeile aus einer Tabelle.
Eigenschaft | Wert |
---|---|
Headerdatei |
Mapidefs.h |
Verwandte Makros: |
CbNewsRowSet, CbsRowSet, SizedsRowSet |
typedef struct _SRowSet
{
ULONG cRows;
SRow aRow[MAPI_DIM];
} SRowSet, FAR *LPSRowSet;
Members
Krähen
Anzahl der SRow-Strukturen im aRow-Member .
aRow
Array von SRow-Strukturen . Es gibt eine Struktur für jede Zeile in der Tabelle.
Hinweise
Eine SRowSet-Struktur wird verwendet, um mehrere Datenzeilen aus einer Tabelle zu beschreiben. SRowSet-Strukturen werden in den Schnittstellenmethoden IAddrBook, ITableData und IMAPITable zusätzlich zu den folgenden Funktionen verwendet:
SRowSet-Strukturen werden wie ADRLIST-Strukturen definiert, damit die Zeilen einer Empfängertabelle und die Einträge in einer Adressliste gleich behandelt werden können. Sowohl SRowSet-Strukturen als auch ADRLIST-Strukturen können an Methoden wie IMessage::ModifyRecipients und IAddrBook::Address übergeben werden.
Außerdem sind die Regeln für die Speicherbelegung für SRowSet-Strukturen identisch mit denen für ADRLIST-Strukturen . Zusammenfassend kann gesagt werden, dass jede SPropValue-Struktur im Array, auf die das lpProps-Element jeder Zeile im Zeilensatz verweist, separat mithilfe von MAPIAllocateBuffer zugeordnet werden muss. Jede Eigenschaftswertstruktur muss auch mithilfe von MAPIFreeBuffer vor der Aufhebung der Zuordnung ihrer SRowSet-Struktur aufgehoben werden, damit Zeiger auf die zugeordneten SPropValue-Strukturen nicht verloren gehen. Der zugeordnete Speicher einer Zeile kann dann beibehalten und außerhalb des Kontexts der SRowSet-Struktur wiederverwendet werden.
Weitere Informationen zur Zuweisung des Arbeitsspeichers für SRowSet-Strukturen finden Sie unter Verwalten von Arbeitsspeicher für ADRLIST- und SRowSet-Strukturen.