ITableData::HrInsertRow
适用于：Outlook 2013 | Outlook 2016
插入表格行。
HRESULT HrInsertRow(
ULONG uliRow,
LPSRow lpSRow
);
参数
uliRow
[in]表示特定行的连续行号。 新行将放在数字指示的行之后。 uliRow 参数可以包含从 0 到 n 的行号，其中 n 是表中的行总数。 在 uliRow 中传递 n 会将行追加到表的末尾。
lpSRow
[in]指向描述要插入的行 的 SRow 结构的指针。
返回值
S_OK
已成功插入行。
MAPI_E_INVALID_PARAMETER
表中已存在其索引列与要插入的行具有相同值的行。
备注
ITableData：：HrInsertRow 方法将行插入表中的特定位置。 新行插入到 位于 uliRow 参数指定位置的行之后。
如果 uliRow 设置为表中的行数，则新行将追加到表的末尾。
充当表索引列的属性必须包含在 lpSRow 参数指向的 SRow 结构的 lpProps 成员中。 此索引属性通常 PR_INSTANCE_KEY (PidTagInstanceKey) ，用于唯一标识将来维护任务的行。
SRow 结构中的属性列不必与表中的属性列的顺序相同。
插入行后，通知将发送到具有表视图且调用表的 IMAPITable：：Advise 方法注册通知的所有客户端或服务提供商。 如果由于限制，插入的行未包含在视图中，则不会发送通知。