<< Щелкните, чтобы показать Содержание >> Разработчику > Объектная модель IS-Builder > Объекты IS-Builder > Почта > IMailServer – почтовый сервер

Метод Logon – выполнить вход на сервер

Contents

Синтаксис:

procedure Logon(

Credentials: IList);

Параметры:

Credentials – параметры входа на почтовый сервер. Состав параметров зависит от типа почтового сервера:

Тип сервера

Параметр

Описание

MAPI

ProfileName

Имя профиля в почтовой программе Microsoft Exchange или Outlook

BodyEncodingGatheringStrategy

Стратегия определения кодировки HTML-содержимого сообщения:

•	Default – получить кодировку из свойства сообщения PR_INTERNET_CPID;

•	GetFromHtmlCharset – получить кодировку из атрибута Charset HTML-содержимого сообщения

POP3

Server

Имя или адрес POP3-сервера

Port

Порт POP3-сервера. Если не указан, используется порт 110

User

Имя пользователя на POP3-сервере

Password

Пароль пользователя на POP3-сервере

EncryptionMode

Режим поддержки шифрования:

•	None – поддержка TLS/SSL не требуется;

•	Implicit – поддержка TLS/SSL на уровне соединения. Если установлен порт 110, выполнится подключение к порту 995, поддерживающему шифрование;

•	RequiredExplicit – поддержка TLS/SSL на уровне передачи данных. Если порт не указан, используется порт 110. Шифрование происходит после успешного выполнения команды STLS, иначе соединение прерывается;

•	OptionalExplicit – поддержка TLS/SSL на уровне передачи данных, если она возможна. Если порт не указан, используется порт 110. Шифрование происходит после успешного выполнения команды STLS, иначе данные передаются без шифрования.

Значение по умолчанию OptionalExplicit

EncryptionVersion

Версия протокола шифрования:

•	TLSv1 – TLS версии 1.0;

•	TLSv1_1 – TLS версии 1.1;

•	TLSv1_2 – TLS версии 1.2;

•	SSLv23 – не рекомендуется использовать. Оставлен для совместимости;

•	SSLv3 – не рекомендуется использовать. Оставлен для совместимости.

Значение по умолчанию TLSv1

ConnectTimeout

Время ожидания подключения. Указывается в миллисекундах. По умолчанию значение не указано. Рекомендуется оставить без изменений

ReadTimeout

Время ожидания данных. Указывается в миллисекундах. По умолчанию значение не указано. Рекомендуется оставить без изменений

SMTP

Server

Имя или адрес SMTP-сервера

Port

Порт SMTP-сервера. Если не указан, используется порт 25

AuthenticationType

Тип аутентификации на SMTP-сервере:

•	None – без аутентификации;

•	Login – аутентификация по имени и паролю

User

Имя пользователя на SMTP-сервере.

Имеет смысл только при типе аутентификации Login

Password

Пароль пользователя на SMTP-сервере.

Имеет смысл только при типе аутентификации Login

EncryptionMode

Режим поддержки шифрования:

•	None – поддержка TLS/SSL не требуется;

•	Implicit – поддержка TLS/SSL на уровне соединения. Если установлен порт 25, выполнится подключение к порту 465, поддерживающему шифрование;

•	RequiredExplicit – поддержка TLS/SSL на уровне передачи данных. Если порт не указан, используется порт 25. Шифрование происходит после выполнения команды STARTTLS;

•	OptionalExplicit – поддержка TLS/SSL на уровне передачи данных, если она возможна. Если порт не указан, используется порт 25. Шифрование происходит после успешного выполнения команды STARTTLS, иначе данные передаются без шифрования.

Значение по умолчанию OptionalExplicit

EncryptionVersion

Версия протокола шифрования:

•	TLSv1 – TLS версии 1.0;

•	TLSv1_1 – TLS версии 1.1;

•	TLSv1_2 – TLS версии 1.2;

•	SSLv23 – не рекомендуется использовать. Оставлен для совместимости;

•	SSLv3 – не рекомендуется использовать. Оставлен для совместимости.

Значение по умолчанию TLSv1

ConnectTimeout

ReadTimeout

SimpleMAPI

ProfileName

Имя профиля в почтовой программе, установленной по умолчанию.

Если не указано, используется профиль по умолчанию

Password

Пароль на доступ к профилю

Описание:

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

Для создания списка Credentials следует использовать метод IMailFactory.CreateParamList. В список следует добавить все необходимые для типа сервера параметры. Если список параметров задан некорректно, то генерируется исключение. Формат исключения зависит от типа сервера.

После завершения работы с почтовым сервером следует вызывать метод Logoff.

Пример:

//Создать почтовую фабрику

MailFactory = CreateObject("SBUM.MailFactory")

//Запросить у фабрики сервер типа "MAPI"

Server = MailFactory.GetServer("MAPI")

//Создать и означить параметры входа

Credentials = MailFactory.CreateParamList()

Credentials.Items("ProfileName") = "Outlook"

//Выполнить вход на сервер

Server.Logon(Credentials)

//...

// Выполнить выход с сервера

Server.Logoff()

См. также

Метод Logoff

Сообщество пользователей DIRECTUM