ITableData::HrModifyRows
Область применения: Outlook 2013 | Outlook 2016
Вставляет несколько строк таблицы, возможно, заменяя существующие строки.
HRESULT HrModifyRows(
ULONG ulFlags,
LPSRowSet lpSRowSet
);
Параметры
ulFlags
[in] ���������������; ������ ���� ����� ����.
lpSRowSet
[в] Указатель на структуру SRowSet , содержащую набор добавляемых строк, при необходимости заменяя существующие строки. Одна из структур значений свойств, на которую указывает член lpProps каждой структуры SRow в наборе строк, должна содержать столбец индекса, то же значение, которое было указано в параметре ulPropTagIndexColumn при вызове функции CreateTable .
Возвращаемое значение
S_OK
Строки были успешно вставлены или изменены.
MAPI_E_INVALID_PARAMETER
Одна или несколько переданных строк не имеют столбца индекса. Если эта ошибка возвращается, строки не изменяются.
Замечания
Метод ITableData::HrModifyRows вставляет строки, описанные структурой SRowSet, на которую указывает параметр lpSRowSet . Если значение столбца индекса строки в наборе строк совпадает со значением для существующей строки в таблице, существующая строка заменяется. Если не существует строки, которая соответствует той, которая включена в структуру SRowSet , HrModifyRows добавляет строку в конец таблицы.
Все представления таблицы изменяются для включения строк, на которые указывает lpSRowSet. Однако если в представлении есть ограничение, исключающее строку, оно может быть невидимым для пользователя.
Столбцы в строках, на которые указывает lpSRowSet, не должны находиться в том же порядке, что и столбцы в таблице. Вызывающий объект также может включать в качестве столбцов свойства, которых в настоящее время нет в таблице. Для существующих представлений HrModifyRows делает эти новые столбцы доступными, но не включает их в текущий набор столбцов. Для будущих представлений HrModifyRows включает новые столбцы в набор столбцов.
После того как HrModifyRows добавит строки, уведомления отправляются всем клиентам или поставщикам служб, у которых есть представление таблицы и которые вызвали метод IMAPITable::Advise таблицы, чтобы зарегистрироваться для получения уведомлений. MAPI отправляет TABLE_ROW_ADDED или TABLE_ROW_MODIFIED уведомления для каждой строки(до восьми строк). Если вызов HrModifyRows затрагивает более восьми строк, MAPI отправляет одно уведомление TABLE_CHANGED.