Construtor TMailMng:New

Cria uma nova instância da classe TMailMng.

Sintaxe

TMailMng():New( < nProtocol >, [ lUseSSL ], [ lUseTLS ], [ lOldTLS ], [ nSSLVersion ], [ nTLSVersion ] )

Parâmetros

Nome	Tipo	Descrição	Obrigatório
nProtocol	numérico	Indica o protocolo que será utilizado para recepção de emails.	X
lUseSSL	lógico	Indica se a conexão utlizará protocolo SSL.
lUseTLS	lógico	Indica se a conexão utlizará protocolo TLS.
lOldTLS	lógico	Indica se utilizará o protocolo SSL v3 para conexão TLS.
nSSLVersion	numérico	Indica a versão que será utilizada do protocolo SSL.
nTLSVersion	numérico	Indica a versão que será utilizada do protocolo TLS.

Retorno

Retorno	Tipo	Descrição
oObj	Objeto	Nova instância da classe TMailMng

Observações

Lista de valores válidos para o parâmetro nProtocol:

Valor	Protocolo
0	POP3
1	IMAP
2	MAPI

Lista de valores válidos para o parâmetro nSSLVersion:

Valor	Versão
0	Não utilizado
1	SSL v2
2	SSL v2 + SSL v3
3	SSL v3

Lista de valores válidos para o parâmetro nTLSVersion:

Valor	Versão
0	Não utilizado
1	TLS v1.0
2	TLS v1.1
3	TLS v1.2

O protocolo MAPI só está disponível em Windows.
O protocolo TLS só só influencia o protocolo SMTP.
Se for utilizado o protocolo MAPI, os parâmetros lUseSSL, lUseTLS, lOldTLS, nSSLVersion e nTLSVersion não têm influência alguma.
Os parâmetros lUseSSL, lUseTLS e lOldTLS são passados como .F. caso não sejam informados.
O valor padrão para o parâmetro nSSLVersion é 0 caso lUseSSL seja .F.; o valor padrão é 3 caso lUseSSL seja .T..
O valor padrão para o parâmetro nTLSVersion é 0 caso lUseTLS seja .F.; o valor padrão é 1 caso lUseTLS seja .T..
Caso lOldTLS seja .T., TLSVersion será 0 e o protocolo utilizado para realizar a conexão TLS será SSL v3.
O parâmetro nSSLVersion é equivalente à chave SSLVersion, da seção Mail. do arquivo ini do Application Server.
O parâmetro nTLSVersion é equivalente à chave TLSVersion, da seção Mail. do arquivo ini do Application Server.

Exemplos

Exemplo 1

oServer1 := TMailMng():New( 0 )                // Objeto com POP3 e SMTP
oServer2 := TMailMng():New( 0, .T. )           // Objeto com POP3+SSL e SMTP+SSL
oServer3 := TMailMng():New( 0, .T., .T. )      // Objeto com POP3+SSL e SMTP+TLS
oServer4 := TMailMng():New( 0, .T., .T., .T. ) // Objeto com POP3+SSL e SMTP usando SSL v3 para o protocolo TLS
oServer5 := TMailMng():New( 1 )                // Objeto com IMAP e SMTP para envio
oServer6 := TMailMng():New( 1, .T. )           // Objeto com IMAP+SSL e SMTP+SSL
oServer7 := TMailMng():New( 1, .T., .T. )      // Objeto com IMAP+SSL e SMTP+TLS
oServer8 := TMailMng():New( 1, .T., .T., .T. ) // Objeto com IMAP+SSL e SMTP usando SSL v3 para o protocolo TLS
oServer9 := TMailMng():New( 2 )                // Objeto com MAPI

Árvore de páginas

TMailMng:New