IMAPITable::GetStatus
Область применения: Outlook 2013 | Outlook 2016
Возвращает состояние и тип таблицы.
HRESULT GetStatus(
ULONG FAR * lpulTableStatus,
ULONG FAR * lpulTableType
);
Параметры
lpulTableStatus
[out] Указатель на значение, указывающее состояние таблицы. Можно вернуть одно из следующих значений:
TBLSTAT_COMPLETE
Никаких операций не выполняется.
TBLSTAT_QCHANGED
Содержимое таблицы ожидаемо изменилось. Это значение состояния не возвращается для изменений, которые являются результатом операций сортировки или ограничения.
TBLSTAT_RESTRICT_ERROR
Ошибка во время операции IMAPITable::Restrict .
TBLSTAT_RESTRICTING
Выполняется операция IMAPITable::Restrict .
TBLSTAT_SETCOL_ERROR
Ошибка во время операции IMAPITable::SetColumns .
TBLSTAT_SETTING_COLS
Выполняется операция IMAPITable::SetColumns .
TBLSTAT_SORT_ERROR
Ошибка во время операции IMAPITable::SortTable .
TBLSTAT_SORTING
Выполняется операция IMAPITable::SortTable .
lpulTableType
[out] Указатель на значение, указывающее тип таблицы. Можно вернуть один из следующих трех типов таблиц:
TBLTYPE_DYNAMIC
Содержимое таблицы является динамическим; значения строк и столбцов могут изменяться по мере изменения базовых данных.
TBLTYPE_KEYSET
Строки в таблице являются фиксированными, но значения столбцов в этих строках являются динамическими и могут изменяться по мере изменения базовых данных.
TBLTYPE_SNAPSHOT
Таблица является статической, и ее содержимое не изменяется при изменении базовых данных.
Возвращаемое значение
S_OK
Состояние таблицы было успешно возвращено.
Замечания
Метод IMAPTable::GetStatus извлекает сведения о типе и текущем состоянии таблицы.
Примечания для вызывающих методов
Вы можете использовать GetStatus в сочетании с тремя другими методами IMAPITable для мониторинга состояния этих операций и определения влияния на таблицу. Вызовите GetStatus после выполнения одного из следующих вызовов IMAPITable:
IMAPITable::Restrict , чтобы задать ограничение.
IMAPITable::SortTable для установления порядка сортировки.
IMAPITable::SetColumns для определения набора столбцов.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::GetStatus |
MFCMAPI использует метод IMAPITable::GetStatus для сообщения о состоянии таблицы. |