TOTVSTEC

Árvore de páginas

Realiza a autenticação no servidor SMTP.

Sintaxe

SMTPAuth( < cUser >, < cPass >, [ cPOPAddress ], [ cPOPPort ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cUser

caractere

Indica o nome de usuário que será utilizado para autenticação.

X


cPass

caractere

Indica a senha do usuário para autenticação.

X


cPOPAddress

caractere

Indica o endereço do servidor POP3 para autenticação.



cPOPPort

caractere

Indica a porta para o servidor POP3 para autenticação.



Retorno

Nome

Tipo

Descrição

nRet

numérico

Retorna 0 (zero) quando a operação é completada com sucesso; caso contrário, retornará um código de erro.

Observações

  • O método leva em consideração os valores das propriedades bExtendSMTP, bAuthLogin, bAuthNTLM e bAuthPlain para realizar a autenticação.
  • Se a conexão utilizada for usando o protocolo MAPI, o método retornará 1 (Operation failed).
  • Se for passado o parâmetro cPOPAddress, o método realizará a autenticação pela conexão com o servidor POP (isto é realizado devido a configuração determinada por alguns servidores de e-mail). Caso contrário, será realizada a autenticação do usuário no servidor SMTP.
  • Caso o parâmetro cPOPPort não seja informado, será definido o valor 110 para a porta.
  • A utilização de cPOPAddress e cPOPPort é equivalente ao uso das chaves AuthSmtp, SmtpPopServer e SmtpPopPort da seção Mail do arquivo ini Application Server.

Exemplos

user Function mail1()
  Local oServer
  Local xRet
  
  oServer := TMailMng():New( 1, 3, 3 )
  
  oServer:cUser := "totvsuser"
  oServer:cPass := "totvspassword"
  oServer:cSMTPAddr := "mail.totvs.com.br"
  
  xRet := oServer:SMTPConnect()
  if xRet <> 0
    conout( "SMTP Connect error: " + oServer:GetErrorString( xRet ) )
    return
  endIf
  
  xRet := oServer:SMTPAuth( oServer:cUser, oServer:cPass )
  if xRet <> 0
    conout( "SMTP Auth error: " + oServer:GetErrorString( xRet ) )
  else
    conout( "Authentication OK!" )
  endif

  xRet := oServer:SMTPDisconnect()
  if xRet != 0
    conout( "SMTPDisconnect error: " + oServer:GetErrorString( xRet ) )
  endIf
return
  • Sem rótulos