Freigeben über


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.

Siehe auch

ADRLIST

SPropValue

SRow

MAPIAllocateBuffer

MAPIFreeBuffer

MAPI-Strukturen