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 方法注册通知的所有客户端或服务提供商。

删除行不会减少现有表视图或随后打开的表视图可用的列,即使删除的行是具有特定列值的最后一行。

另请参阅

CreateTable

ITableData::HrDeleteRow

ITableData::HrModifyRows

SRowSet

TABLE_NOTIFICATION

ITableData : IUnknown