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