Поделиться через


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 для получения отображаемой таблицы папок получения.

См. также

IMAPITable::QueryColumns

IMAPITable::QueryRows

IMAPITable::QuerySortOrder

IMAPITable::SetColumns

IMsgStore: IMAPIProp

Mfcmapi (en) � �������� ������� ����