|
Метод SearchInbox – найти входящие сообщения |
 
 |
|
Метод SearchInbox – найти входящие сообщения |
|
Синтаксис:
Параметры:
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)