IMAPISession::GetStatusTable
Область применения: Outlook 2013 | Outlook 2016
Предоставляет доступ к таблице состояния— таблице, содержащей сведения обо всех ресурсах MAPI в сеансе.
HRESULT GetStatusTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Параметры
ulFlags
[в] Битовая маска флагов, которая определяет формат столбцов, которые являются символьными строками. Можно задать следующий флаг:
MAPI_UNICODE
Строковые столбцы имеют формат Юникода. Если флаг MAPI_UNICODE не задан, строковые столбцы имеют формат ANSI.
lppTable
[out] Указатель на указатель на таблицу состояния.
Возвращаемое значение
S_OK
Таблица успешно возвращена.
Замечания
Метод IMAPISession::GetStatusTable предоставляет доступ к таблице состояния, содержащей сведения обо всех ресурсах MAPI в сеансе. В таблице содержится одна строка для сведений о подсистеме MAPI, одна строка для диспетчера очереди MAPI, одна строка для интегрированной адресной книги и одна строка для каждого поставщика услуг в профиле.
Полный список обязательных и необязательных столбцов в таблице состояния см. в разделе Таблицы состояния.
Задание флага MAPI_UNICODE в параметре ulFlags влияет на формат столбцов, возвращаемых методами IMAPITable::QueryColumns и IMAPITable::QueryRows . Этот флаг также управляет типами свойств в порядке сортировки, возвращаемом методом IMAPITable::QuerySortOrder .
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnStatusTable |
MFCMAPI использует метод IMAPISession::GetStatusTable для получения таблицы состояния для отрисовки. |