IProviderAdmin::GetProviderTable
Область применения: Outlook 2013 | Outlook 2016
Предоставляет доступ к таблице поставщиков службы сообщений, списку поставщиков служб в службе сообщений.
HRESULT GetProviderTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Параметры
ulFlags
[в] Битовая маска флагов, управляющая типом строк, возвращаемых в столбцах таблицы поставщиков. Можно задать следующий флаг:
MAPI_UNICODE
Строковые столбцы имеют формат Юникода. Если флаг MAPI_UNICODE не задан, столбцы имеют формат ANSI.
lppTable
[out] Указатель на указатель на таблицу поставщика.
Возвращаемое значение
S_OK
Таблица поставщиков успешно возвращена.
Замечания
Метод IProviderAdmin::GetProviderTable извлекает указатель на таблицу поставщиков службы сообщений— таблицу, которую поддерживает MAPI, содержащую сведения о каждом поставщике служб в службе сообщений.
В отличие от таблицы поставщиков, возвращаемой методом IMsgServiceAdmin::GetProviderTable , таблица поставщиков, возвращаемая методом IProviderAdmin::GetProviderTable , может содержать дополнительные строки, представляющие сведения, связанные с одним или несколькими поставщиками служб в службе сообщений. Эти дополнительные сведения добавляются в профиль с разделами ключевое слово файла Mapisvc.inf. Если у поставщика есть дополнительные разделы профиля, структуры MAPIUID для этих разделов сохраняются в свойстве PR_SERVICE_EXTRA_UIDS (PidTagServiceExtraUids). PR_SERVICE_EXTRA_UIDS сохраняется в разделе профиль службы сообщений.
Поставщики, которые были удалены или используются, но помечены для удаления, не включаются в таблицу поставщиков. Таблицы поставщиков являются статическими, что означает, что последующие добавления или удаления из службы сообщений не отражаются в таблице.
Если у службы сообщений нет поставщиков, IProviderAdmin::GetProviderTable возвращает таблицу с нулевым числом строк и значением S_OK.
Задание флага MAPI_UNICODE в параметре ulFlags влияет на формат столбцов, возвращаемых методами IMAPITable::QueryColumns и IMAPITable::QueryRows .
Этот флаг также управляет типами свойств в порядке сортировки, возвращаемом методом IMAPITable::QuerySortOrder .
Полный список столбцов в таблице поставщиков см. в разделе Таблица поставщиков.
Примечания для вызывающих методов
Чтобы получить строки таблицы поставщика в порядке транспорта, отсортируйте таблицу по столбцу PR_PROVIDER_ORDINAL (PidTagProviderOrdinal).
Чтобы получить только те строки, которые представляют поставщиков услуг (без включения дополнительных строк), ограничьте извлечение строками, имеющими значение PT_ERROR в столбце PR_RESOURCE_TYPE (PidTagResourceType).
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| MsgServiceTableDlg.cpp |
CMsgServiceTableDlg::OnDisplayItem |
MFCMAPI использует метод IProviderAdmin::GetProviderTable для получения таблицы поставщиков для отрисовки в новом диалоговом окне. |