IMAPISupport::ModifyStatusRow
Область применения: Outlook 2013 | Outlook 2016
Изменяет таблицу состояния путем добавления новой строки или изменения существующей строки.
HRESULT ModifyStatusRow(
ULONG cValues,
LPSPropValue lpColumnVals,
ULONG ulFlags
);
Параметры
cValues
[в] Количество свойств, включаемых в новую или измененную строку таблицы состояния.
lpColumnVals
[в] Указатель на массив значений свойств, описывающих свойства, которые должны быть включены в качестве столбцов в новой или измененной строке таблицы состояния.
ulFlags
[в] Битовая маска флагов, управляющая обработкой сведений, определяющих строку таблицы состояния. Можно задать следующий флаг:
STATUSROW_UPDATE
Позволяет MAPI объединить свойства, включенные в массив, на который указывает lpColumnVals , с существующей строкой таблицы состояния, а не в новой строке.
Возвращаемое значение
S_OK
Таблица состояния успешно обновлена.
Замечания
Метод IMAPISupport::ModifyStatusRow реализован для всех объектов поддержки поставщика услуг. Поставщики услуг вызывают ModifyStatusRow во время входа, чтобы добавить строку в таблицу состояния, а в другое время во время сеанса — для обновления строки. ModifyStatusRow предоставляет MAPI сведения, необходимые для создания таблицы состояния.
Примечания для вызывающих методов
Установите флаг STATUSROW_UPDATE при вызове ModifyStatusRow , чтобы внести изменения в свойства в строке существующей таблицы состояний. Это информирует MAPI о том, что в параметре lpColumnVals передаются только изменяемые столбцы.
Клиенты могут использовать сведения в таблице состояния для доступа к объекту состояния.
Полный список столбцов, которые следует включить в строку таблицы состояния, см. в разделе Таблицы состояния.