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 | Referência |
---|---|---|---|---|
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
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