Метод Logon – выполнить вход на сервер
Contents
Синтаксис:
procedure Logon( Options: IList); |
Параметры:
Options – параметры входа на почтовый сервер. Состав параметров зависит от типа почтового сервера:
Тип сервера |
Параметр |
Описание |
||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
MAPI |
ProfileName |
Имя профиля в почтовой программе Microsoft Exchange или Outlook |
||||||||||||||||
|
BodyEncodingGatheringStrategy |
Стратегия определения кодировки HTML-содержимого сообщения:
|
||||||||||||||||
|
Folder |
Имя папки, из которой захватываются письма |
||||||||||||||||
|
MaxCount |
Максимальное число сообщений для единовременного получения с сервера. Необязательный параметр. Если значение не указано, то осуществляется получение всех сообщений |
||||||||||||||||
POP3/IMAP |
Server |
Имя/адрес POP3- или IMAP-сервера |
||||||||||||||||
Port |
Порт POP3- или IMAP -сервера. Если не указан порт POP3-сервера, используется порт 110. Если не указан порт IMAP –сервера, используется порт 143 |
|||||||||||||||||
User |
Имя пользователя на POP3- или IMAP -сервере |
|||||||||||||||||
Password |
Пароль пользователя на POP3- или IMAP -сервере |
|||||||||||||||||
EncryptionMode |
При установке связи с POP3- или IMAP -сервером шифруется канал передачи данных или передаваемые данные. Настройки шифрования для РOP3-сервера:
Значение по умолчанию OptionalExplicit.
Настройки шифрования для IMAP-сервера:
Значение по умолчанию OptionalExplicit |
|||||||||||||||||
EncryptionVersion |
Версия протокола шифрования:
Значение по умолчанию TLSv1 |
|||||||||||||||||
ConnectTimeout |
Время ожидания подключения. Указывается в миллисекундах. Значение по умолчанию 0. В этом случае сервер ожидает подключение до тех пор, пока оно не будет установлено |
|||||||||||||||||
ReadTimeout |
Время ожидания данных. Указывается в миллисекундах. Значение по умолчанию -1. В этом случае сервер ожидает данные до тех пор, пока они не будут получены. Рекомендуется оставить без изменений |
|||||||||||||||||
Folder |
Имя папки, из которой захватываются письма. Необязательный параметр для IMAP-сервера. Если настройка не указана, то выполняется поиск писем в папке «Входящие». Параметр не поддерживается для POP3-сервера |
|||||||||||||||||
MaxCount |
Максимальное число сообщений для единовременного получения с сервера. Необязательный параметр. Если значение не указано, то осуществляется получение всех сообщений |
|||||||||||||||||
SMTP |
Server |
Имя или адрес SMTP-сервера |
||||||||||||||||
Port |
Порт SMTP-сервера. Если не указан, используется порт 25 |
|||||||||||||||||
AuthenticationType |
Тип аутентификации на SMTP-сервере:
|
|||||||||||||||||
User |
Имя пользователя на SMTP-сервере. Имеет смысл только при типе аутентификации Login |
|||||||||||||||||
Password |
Пароль пользователя на SMTP-сервере. Имеет смысл только при типе аутентификации Login |
|||||||||||||||||
EncryptionMode |
Режим поддержки шифрования:
Значение по умолчанию OptionalExplicit |
|||||||||||||||||
EncryptionVersion |
Версия протокола шифрования:
Значение по умолчанию TLSv1 |
|||||||||||||||||
ConnectTimeout |
Время ожидания подключения. Указывается в миллисекундах. По умолчанию значение не указано. Рекомендуется оставить без изменений |
|||||||||||||||||
ReadTimeout |
Время ожидания данных. Указывается в миллисекундах. По умолчанию значение не указано. Рекомендуется оставить без изменений |
|||||||||||||||||
SimpleMAPI |
ProfileName |
Имя профиля в почтовой программе, установленной по умолчанию. Если не указано, используется профиль по умолчанию |
||||||||||||||||
Password |
Пароль доступа к профилю в почтовой программе |
Описание:
Метод выполняет вход на почтовый сервер. Следует вызывать перед началом любой работы с сервером, например, перед получением входящих или отправкой исходящих сообщений.
Для создания списка Options следует использовать метод IMailFactory.CreateParamList. В список следует добавить все необходимые для типа сервера параметры. Если список параметров задан некорректно, то генерируется исключение. Формат исключения зависит от типа сервера.
После завершения работы с почтовым сервером следует вызывать метод Logoff.
Пример:
//Создать почтовую фабрику
MailFactory = CreateObject("SBUM.MailFactory")
//Запросить у фабрики сервер типа "MAPI"
Server = MailFactory.GetServer("MAPI")
//Создать и означить параметры входа
Options = MailFactory.CreateParamList()
Options.Items("ProfileName") = "Outlook"
//Выполнить вход на сервер
Server.Logon(Options)
//...
// Выполнить выход с сервера
Server.Logoff()
Метод Logoff |
| © Компания Directum, 2020 | Сообщество пользователей Directum |