POP3_Login

4D Internet Commands v16

POP3_Login


POP3_Login ( nomeServidor ; nomeUsuario ; senha ; aPOP ; pop3_ID {; paramSessao} ) -> Resultado

Parâmetro	Tipo	Descrição
nomeServidor	String	Nome ou direção IP do servidor de correio POP3
nomeUsuario	String	Nome do usuário
senha	String	Senha
aPOP	Inteiro	0 = Conexão texto plano, 1 = Conexão APOP
pop3_ID	Inteiro longo	Referencia a esta conexão POP3
paramSessao	Inteiro longo	1 = Use SSL, 0 se omite = Não utilizar SSL
Resultado	Inteiro	Código de erro

Descrição

O comando POP3_Login conecta ao usuário definido por nomeUsuario e senha ao servidor de correio POP3. Se aPOP vale 1, o mecanismo APOP (RFC#1321) se utiliza para a conexão. Se aPOP é zero ou está vazio, a conexão é feita normalmente, com uma senha em texto plano. pop3_Login devolve um número de identificação para a conexão (pop3_ID) que os comandos posteriores deverão utilizar.

Atenção: Os servidores POP3 não foram desenhados para ser acessíveis de forma interativa. Uma vez conectado a um servidor, deve realizar as ações necessárias e depois se desconectar do servidor o mais rápido possível. Entre as chamadas de POP3_Login e POP3_Logout, seu procedimento não deve participar em telas de usuário interativo. Um servidor POP3 desconectará automaticamente todas as reuniões que não apresentem atividade durante um certo período de tempo. De acordo com o RFC para POP3, o período de inatividade autorizado é de mínimo 30 minutos. No entanto, nossa experiência demonstrou que a maioria de servidores desconectam aos usuários inativos depois de um período muito mais curto de tempo.

Cada comando que interage com o servidor POP3 provoca um reinicio de seu contador de inatividade. Se o servidor interrompe a conexão antes de que tenha chamado a POP3_Logout, todas as eliminações que realizou são canceladas.

nomeServidor é o nome ou o endereço IP do servidor de correio POP3. Se recomenda utilizar o nome do servidor, se é necessário, pode utilizar um endereço IP.

nomeUsuario é o nome do usuário do servidor de correio POP3. O parâmetro nomeUsuario não deve conter o domínio. Por exemplo, para o email "jack@4d.com", o nomeUsuario é "jack".

senha é a senha correspondente a nomeUsuario no servidor de correio POP3.

O parâmetro aPOP é um valor inteiro que indica se o mecanismo APOP deve ser utilizado para a conexão. Passe 1 para utilizar o mecanismo APOP. Passe zero para realizar a conexão com senha no texto plano. O valor por padrão é zero.

pop3_ID é uma variável de tipo inteiro longo na qual é devolvida uma referencia à conexão que se acaba de estabelecer. A variável se utiliza em todos os comandos posteriores que realizam ações relacionadas com esta sessão.

O parâmetro opcional paramSessao permite ativar o protocolo SSL para a conexão:

Se passa 1, a conexão ao servidor POP3 é realizada em SSL (modo síncrono),
Se passa 0 ou omite este parâmetro, a conexão é realizada em modo padrão, não seguro.

Ver também

POP3_Logout