ITableData::HrModifyRow

适用于:Outlook 2013 | Outlook 2016

插入新的表行,可能替换现有行。

HRESULT HrModifyRow(
  LPSRow lpSRow
);

参数

lpSRow

[in]指向 SRow 结构的指针,该结构描述要添加的行或替换现有行。 SRow 结构的 lpProps 成员指向的属性值结构之一应包含索引列,该值与调用 CreateTable 函数时 ulPropTagIndexColumn 参数中指定的值相同。

返回值

S_OK

已成功插入或修改行。

MAPI_E_INVALID_PARAMETER

传入行没有索引列。

备注

ITableData::HrModifyRow 方法插入 lpSRow 参数指向的 SRow 结构所描述的行。 如果表中已存在 与 lpSRow 指向的行的索引列具有相同值的行,则替换现有行。 如果不存在与 SRow 结构中包含的行匹配的行, HrModifyRow 会将该行添加到表的末尾。

将修改表的所有视图,以包括 lpSRow 指向的行。 但是,如果视图存在排除行的限制,则用户可能看不到该行。

lpSRow 指向的行中的列不必与表中的列相同。 调用方还可以包含当前不在表中的列属性。 对于现有视图, HrModifyRow 使这些新列可用,但不包括在当前列集中。 对于将来的视图, HrModifyRow 包括列集中的新列。

HrModifyRow 添加行后,通知将发送到具有表视图且调用表的 IMAPITable::Advise 方法以注册通知的所有客户端或服务提供商。

另请参阅

SRow

TABLE_NOTIFICATION

ITableData : IUnknown