SRowSet

适用于:Outlook 2013 | Outlook 2016

包含 SRow 结构的数组。 每个 SRow 结构描述表中的一行。

属性
标头文件:
Mapidefs.h
相关宏:
CbNewSRowSetCbSRowSetSizedSRowSet
typedef struct _SRowSet
{
  ULONG cRows;
  SRow aRow[MAPI_DIM];
} SRowSet, FAR *LPSRowSet;

Members

乌鸦

aRow 成员中的 SRow 结构的计数。

aRow

SRow 结构的数组。 表中的每一行都有一个结构。

备注

SRowSet 结构用于描述表中的多行数据。 除了以下函数外,SRowSet 结构还用于 IAddrBookITableDataIMAPITable 接口方法:

SRowSet 结构的定义与 ADRLIST 结构相同,以允许收件人表的行和地址列表中的条目得到相同的处理。 SRowSet 结构和 ADRLIST 结构都可以传递给 IMessage::ModifyRecipientsIAddrBook::Address 等方法。

此外, SRowSet 结构的内存分配规则与 ADRLIST 结构的内存分配规则相同。 总之,行集中每一行的 lpProps 成员指向的数组中的每个 SPropValue 结构必须使用 MAPIAllocateBuffer 单独分配。 在解除分配其 SRowSet 结构之前,还必须使用 MAPIFreeBuffer 解除分配每个属性值结构,以便指向已分配的 SPropValue 结构的指针不会丢失。 然后,可以在 SRowSet 结构的上下文之外保留和重用行的分配内存。

有关如何为 SRowSet 结构分配内存的详细信息,请参阅 管理 ADRLIST 的内存和 SRowSet 结构

另请参阅

ADRLIST

SPropValue

SRow

MAPIAllocateBuffer

MAPIFreeBuffer

MAPI 结构