ITableData::HrInsertRow
Область применения: Outlook 2013 | Outlook 2016
Вставляет строку таблицы.
HRESULT HrInsertRow(
ULONG uliRow,
LPSRow lpSRow
);
Параметры
uliRow
[в] Последовательный номер строки, представляющий определенную строку. Новая строка будет размещена после строки, указываемой числом. Параметр uliRow может содержать номера строк от 0 до n, где n — общее количество строк в таблице. Передача n в uliRow добавляет строку в конец таблицы.
lpSRow
[в] Указатель на структуру SRow , которая описывает вставляемую строку.
Возвращаемое значение
S_OK
Строка успешно вставлена.
MAPI_E_INVALID_PARAMETER
Строка, которая имеет то же значение для столбца индекса, что и вставляемая строка, уже существует в таблице.
Замечания
Метод ITableData::HrInsertRow вставляет строку в таблицу в определенной позиции. Новая строка вставляется после строки, которая находится в позиции, заданной параметром uliRow .
Если для параметра uliRow задано количество строк в таблице, новая строка добавляется в конец таблицы.
Свойство, выступающее в качестве столбца индекса для таблицы, должно быть включено в элемент lpProps структуры SRow, на который указывает параметр lpSRow . Это свойство индекса, обычно PR_INSTANCE_KEY (PidTagInstanceKey), используется для уникальной идентификации строки для будущих задач обслуживания.
Столбцы свойств в структуре SRow не должны быть в том же порядке, что и столбцы свойств в таблице.
После вставки строки уведомления отправляются всем клиентам или поставщикам служб, которые имеют представление таблицы и вызвали метод IMAPITable::Advise таблицы для регистрации уведомлений. Уведомление не отправляется, если вставленная строка не включена в представление из-за ограничения.