IMAPITable::QueryColumns
Область применения: Outlook 2013 | Outlook 2016
Возвращает список столбцов для таблицы.
HRESULT QueryColumns(
ULONG ulFlags,
LPSPropTagArray FAR * lpPropTagArray
);
Параметры
ulFlags
[в] Битовая маска флагов, указывающая, какой набор столбцов должен быть возвращен. Можно задать следующий флаг:
TBL_ALL_COLUMNS
Таблица должна возвращать все доступные столбцы.
lpPropTagArray
[out] Указатель на структуру SPropTagArray , содержащую теги свойств для набора столбцов.
Возвращаемое значение
S_OK
Набор столбцов успешно возвращен.
MAPI_E_BUSY
Выполняется другая операция, которая предотвращает запуск операции получения набора столбцов. Либо выполняющиеся операции должны быть разрешены к завершению, либо она должна быть остановлена.
Замечания
Для получения можно вызвать метод IMAPITable::QueryColumns :
Столбец по умолчанию для таблицы.
Текущий набор столбцов для таблицы, установленный вызовом метода IMAPITable::SetColumns .
Полный набор столбцов для таблицы, столбцы, которые доступны, но не обязательно являются частью текущего набора.
Примечания для вызывающих методов
Если флаг TBL_ALL_COLUMNS не задан, IMAPITable::QueryColumns возвращает набор столбцов по умолчанию или текущий набор столбцов таблицы в зависимости от того, была ли затронута таблица вызовом IMAPITable::SetColumns. SetColumns изменяет порядок и выбор столбцов в наборе столбцов таблицы.
Если задать флаг TBL_ALL_COLUMNS, QueryColumns возвращает все столбцы, которые могут быть в наборе столбцов таблицы.
Освободите память для массива тегов свойств, на который указывает параметр lpPropTagArray , вызвав функцию MAPIFreeBuffer .
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::D oSetColumns |
MFCMAPI использует метод IMAPITable::QueryColumns для получения текущего набора столбцов для таблицы, чтобы пользователь смог изменить его. |