Объекты DIRECTUM

 

Объект IMailServer

 

Метод SearchInbox – найти входящие сообщения

Синтаксис:

function SearchInbox(

  Criteria: IList): IList;

Параметры:

Criteria – список критериев отбора входящих сообщений. Список может содержать следующие критерии:

·         FromName – имя отправителя;

·         FromAddress – адрес отправителя;

·         Subject – тема сообщения;

·         MaxSize – максимальный размер сообщения в байтах;

·         Importance – важность сообщения. Возможные значения: «Low» – низкая, «Normal» – обычная, «High» – высокая;

·         Read – признак прочтенности сообщения. Не рекомендуется использовать для сервера POP3, т.к. POP3-сервера не обеспечивают полноценной работы с признаком прочтенности письма.

Возвращаемое значение:

Список сообщений, удовлетворяющих указанным критериям. Имена элементов списка содержат ИД сообщений, значения – объекты IMessage.

Если список критериев не означен или не содержит ни одного критерия, то возвращаются все входящие сообщения, обнаруженные на сервере.

Описание:

Метод имеет смысл только для серверов, поддерживающих работу с входящими сообщениями (MAPI, POP3).

Метод выполняет поиск входящих сообщений и возвращает найденные сообщения в виде списка.

Для создания списка Criteria следует использовать метод IMailFactory.CreateParamList.

Для тех серверов, которые поддерживают несколько хранилищ сообщений и папок для входящих сообщений, работа ведется только с хранилищем и папкой входящих сообщений по умолчанию.

Пример использования:

//Создать параметры фильтрации

SearchCriteria = MailFactory.CreateParamList()

//Добавить критерий по непрочтенным сообщениям

SearchCriteria.Items("Read") = False

//Добавить критерий по сообщениям с высокой важностью

SearchCriteria.Items("Importance") = "High"

//Найти во "Входящих" все сообщения по указанным критериям

IncomingMessages = Server.SearchInbox(SearchCriteria)