ITableData::HrDeleteRows
适用于:Outlook 2013 | Outlook 2016
删除多个表行。
HRESULT HrDeleteRows(
ULONG ulFlags,
LPSRowSet lprowsetToDelete,
ULONG FAR * cRowsDeleted
);
参数
ulFlags
[in]控制删除的标志的位掩码。 可以设置以下标志:
TAD_ALL_ROWS
删除表中的所有行和所有相应的视图,发送单个TABLE_RELOAD通知。
lprowsetToDelete
[in]指向描述要删除的行的行集的指针。 如果在 ulFlags 参数中设置了TAD_ALL_ROWS标志,则 lprowsetToDelete 参数可以为 NULL。
cRowsDeleted
[out]已删除行的计数。
返回值
S_OK
已成功删除表行。
备注
ITableData::HrDeleteRows 方法查找并删除包含与行集中每个 aRow 条目的 lpProps 成员指向的属性匹配的列的表行。 索引列用于标识每一行;此列的属性标记必须与调用 CreateTable 函数时在 ulPropTagIndexColumn 参数中传递的属性标记相同。
在 cRowsDeleted 中返回实际删除的行数。 如果找不到一行或多行,则不会返回错误。
删除行后,通知将发送到具有表视图并调用表的 IMAPITable::Advise 方法注册通知的所有客户端或服务提供商。
删除行不会减少现有表视图或随后打开的表视图可用的列,即使删除的行是具有特定列值的最后一行。