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