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