IABLogon::GetOneOffTable
Область применения: Outlook 2013 | Outlook 2016
Возвращает таблицу одноразовых шаблонов для создания получателей, добавляемых в список получателей исходящего сообщения.
HRESULT GetOneOffTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Параметры
ulFlags
[в] Битовая маска флагов, управляющая типом строковых столбцов, включенных в таблицу. Можно задать следующий флаг:
MAPI_UNICODE
Строковые столбцы имеют формат Юникода. Если флаг MAPI_UNICODE не задан, строковые столбцы имеют формат ANSI.
lppTable
[out] Указатель на указатель на однократную таблицу.
Возвращаемое значение
S_OK
Разовая таблица успешно получена.
MAPI_E_BAD_CHARWIDTH
Либо был установлен флаг MAPI_UNICODE, а поставщик адресной книги не поддерживает Юникод, либо MAPI_UNICODE не задан, а поставщик адресной книги поддерживает только Юникод.
MAPI_E_NO_SUPPORT
Поставщик адресной книги не предоставляет одноразовые шаблоны.
Замечания
MAPI вызывает метод GetOneOffTable , чтобы сделать доступными одноразовые шаблоны для создания получателей. Новые получатели добавляются в список получателей исходящего сообщения. Поставщики адресных книг должны поддерживать уведомления в своей однократной таблице, чтобы сообщить MAPI об изменениях шаблона. MAPI сохраняет разовую таблицу открытой, чтобы включить динамическое обновление.
Поставщики адресных книг также могут поддерживать разовую таблицу для каждого контейнера. Вызывающие объекты извлекают эту разовую таблицу, вызывая метод IMAPIProp::OpenProperty контейнера и запрашивая свойство PR_CREATE_TEMPLATES (PidTagCreateTemplates). Шаблоны, доступные в этой таблице, используются для добавления получателей в контейнер. Сведения о различиях между двумя типами однократных таблиц см. в разделе Реализация таблиц One-Off.
Список обязательных столбцов в однократной таблице поставщика адресной книги см. в разделе Одноуровневые таблицы.