IMessage::GetRecipientTable
Область применения: Outlook 2013 | Outlook 2016
Возвращает таблицу получателей сообщения.
HRESULT GetRecipientTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Параметры
ulFlags
[в] Битовая маска флагов, управляющая возвратом таблицы. Можно задать следующие флаги:
MAPI_DEFERRED_ERRORS
Позволяет GetRecipientTable успешно возвращать данные, возможно, до того, как таблица будет полностью доступна вызывающому клиенту. Если таблица недоступна, последующий вызов может вызвать ошибку.
MAPI_UNICODE
Строковые столбцы должны быть в формате Юникода. Если флаг MAPI_UNICODE не задан, строковые столбцы должны иметь формат ANSI.
lppTable
[out] Указатель на указатель на таблицу получателей.
Возвращаемое значение
S_OK
Таблица получателей была успешно возвращена.
Замечания
Метод IMessage::GetRecipientTable возвращает указатель на таблицу получателей сообщения, которая содержит сведения обо всех получателях сообщения. Для каждого получателя имеется одна строка.
Таблицы получателей имеют другой набор столбцов в зависимости от того, было ли отправлено сообщение. Полный список столбцов в таблице получателей см. в разделе Таблицы получателей.
Некоторые таблицы получателей поддерживают широкий спектр ограничений; другие нет. Поддержка ограничений зависит от реализации поставщика хранилища сообщений.
Установка флага MAPI_UNICODE в параметре ulFlags влияет на следующие вызовы таблицы получателей:
IMAPITable::QueryColumns для получения набора столбцов.
IMAPITable::QueryRows для получения строк.
IMAPITable::QuerySortOrder для получения порядка сортировки.
При установке флага Юникода требуется, чтобы сведения для всех строковых столбцов, возвращаемых этими вызовами, были в формате Юникода. Однако, поскольку не все поставщики хранилища сообщений поддерживают Юникод, установка этого флага — это только запрос.
Примечания для вызывающих методов
Вы можете изменить таблицу получателей, когда она открыта, вызвав метод IMessage::ModifyRecipients . ModifyRecipients добавляет получателей, удаляет их или изменяет свойства получателей.