AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Comunicación / Gestión de correos electrónicos
  • Properties specific to emailSMTPSession variables
  • Functions that use emailSMTPSession variables
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
The emailSMTPSession type is used to access a messaging server by using the SMTP protocol (Simple Mail Transfer Protocol) in order to send emails. You can define and change the characteristics of the connection using different WLanguage properties.
Remarks:
  • For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
  • In most cases, the SMTP server to use is the SMTP server of Internet provider (and not the one of email account). For example, if you have Internet access via Orange and a Free email account, you must use the SMTP server of Orange (and not the one of Free). To use a different SMTP server, you must use an authenticated SMTP server, that requires a secure connection in most cases.
Ejemplo
Propiedades

Properties specific to emailSMTPSession variables

The following properties can be used to define the characteristics of emailSMTPSession variables:
Property nameType used Effect
AsynchronousBoolean or Integer constant
  • emailAsynchronous (or True) if the emails sent during the session started by EmailStartSMTPSession must be transmitted in asynchronous mode.
  • emailSynchronous (or False) otherwise (default value).
AuthTokenAuthToken variableEmail server access token to be used when if the OAuth 2.0 protocol is used (two-factor authentication). This access token is retrieved by AuthIdentify.
IgnoreErrorInteger constantSpecifies the ignored errors. Corresponds to a constant or to a combination of constants:
  • emailSessionIgnoreCertificateInvalid Certificate is ignored.
  • emailSessionIgnoreNameCertificateInvalid The site name in the certificate is ignored.
  • emailSessionIgnoreCertificateExpired Certificate date is ignored.
  • emailSessionIgnoreRevocation The check in the list of revoked certificates is ignored.
Warning This property can only be used if the email function uses the cross-platform implementation (set with the EmailConfigure function). To use this implementation, use the following line of code:
EmailConfigure(emailParameterMode, 1)
Name Character stringUsername to be used for authenticated SMTP sessions.
OptionInteger constantOptions of SMTP connection. The possible values are:
  • emailOptionDefault (default value):
    Start a non-secure SMTP session. In this case, the standard port is 25.
  • emailProtocolSMTPS:
    Start an SMTP session secured by the TLS protocol. In this mode:
    • the initial connection is established without encryption, then a STARTTLS command is sent to start encryption,
    • the standard port is 587.
  • optionTLS:
    Start an SMTP session secured by the TLS protocol. In this case, the standard port is 465.
PasswordCharacter string or Secret stringUser password. This password is given by the service provider or by the network administrator. This password is used to start an authenticated SMTP session.
Novedad versión 2025
Cadenas secretas: Si utiliza el almacén de cadenas secretas, el tipo de cadena secreta utilizado para este parámetro debe ser "ANSI o Unicode string".
Para obtener más información sobre las cadenas secretas y el almacén, consulte Almacén de cadenas secretas.
PortIntegerIdentifies the port used for SMTP (25 by default).
ServerAddressCharacter stringDNS name or IP address of email server (outgoing protocol). This address is supplied by the service provider or by the network administrator.
Warning You must use the SMTP server of your Internet connection provider. This SMTP server may have no link with the SMTP server associated with the email account.

Remark: Modification of constant names (version 28 Update 4):
In version 28 Update 4, theses constants were renamed for better code readability. Constant names correspond as follows:
  • emailOptionSecuredTLS is now emailProtocolSMTPS.
  • optionSSL is now optionTLS.
The old constant names:
  • are no longer recognized by syntax highlighting,
  • no longer appear in the code completion suggestions,
  • can still be used without causing a compilation error or unexpected behavior at runtime.
Observaciones

Functions that use emailSMTPSession variables

EmailCloseSessionCloses an email management session depending on the selected mode (SMTP/POP3, IMAP, MS Exchange or Lotus Notes).
EmailSendMessageSends an email using a given protocol (SMTP, MS Exchange, Lotus Notes, Outlook).
EmailStartSessionStarts an email management session based on the selected management mode (POP3, SMTP, IMAP or MS Exchange).
Versión mínima requerida
  • Versión 15
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 16/05/2025

Señalar un error o enviar una sugerencia | Ayuda local