ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / Managing emails
  • Protocole POP3
  • Session et nom d'utilisateur
  • Délai de timeout
  • Fonctionnalité d'application requise
  • Gmail : Que faire si une connexion à Gmail (SMTP, IMAP, POP3) échoue avec une erreur de certificat ?
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Ouvre une session de réception et de lecture d'emails avec le protocole POP3. Il sera uniquement possible de lire des emails. Il est possible d'ouvrir une session POP3 sécurisée via SSL.
Remarque : Pour ouvrir une session d'envoi d'emails, utilisez la fonction EmailOuvreSessionSMTP.
Exemple
// Lecture d'un email par le protocole POP3
SI EmailOuvreSessionPOP3(USER, PASSWORD, "pop3.fournisseur.fr") = Vrai ALORS
NomUser = USER
SINON
NomUser = ""
Erreur("Impossible d'établir la connexion")
FIN
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)Ajax
// Connexion à un serveur POP3 nécessitant une connexion SSL par exemple, gmail
// 995 est le port standard pour ce type de service
EmailOuvreSessionPOP3(SAI_SESSION, SAI_PASS, SAI_POP, 995, optionTLS)
 
// Connexion à un serveur POP non sécurisé
EmailOuvreSessionPOP3(SAI_SESSION, SAI_PASS, SAI_POP, 110)
// 110 est le port standard pour ce type de service.
// C'est aussi la valeur par défaut de la fonction,
// On peut donc écrire plus simplement
EmailOuvreSessionPOP3(SAI_SESSION, SAI_PASS, SAI_POP)
Syntaxe
<Résultat> = EmailOuvreSessionPOP3(<Nom utilisateur> , <Mot de passe> , <Adresse serveur POP3> [, <Numéro port POP3> [, <Option>]])
<Résultat> : Booléen
  • Vrai si la session a été ouverte,
  • Faux dans le cas contraire. En cas d'erreur, la variable ErreurDétectée est à Vrai.
    Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Nom utilisateur> : Chaîne de caractères
Identifie l'utilisateur. Ce nom est fourni par le fournisseur de services ou par l'administrateur réseau. Ce nom permettra d'identifier la session d'emails dans les différentes fonctions de gestion des emails.
<Mot de passe> : Chaîne de caractères
Mot de passe de l'utilisateur. Ce mot de passe est fourni par le fournisseur de services ou par l'administrateur réseau.
<Adresse serveur POP3> : Chaîne de caractères
Adresse IP du serveur d'emails (protocole entrant). Cette adresse IP est fournie par le fournisseur de services ou par l'administrateur réseau. Cette adresse IP peut être donnée sous la forme :
  • Adresse IP au format XXX.XXX.XXX.XXX ( par exemple, 125.5.110.100).
  • Adresse IP contenant le nom du serveur (par exemple, pop3.freesbee.fr). Cette syntaxe est conseillée.
  • Adresse IP obtenue par la fonction NetAdresseIP.
<Numéro port POP3> : Entier optionnel
Identifie le port utilisé pour le protocole POP3 (110 par défaut).
<Option> : Constante optionnelle de type Entier
Permet d'indiquer si une connexion SSL est nécessaire :
optionTLSConnexion SSL nécessaire (cas d'un serveur POP3 sécurisé).
Remarque : le port généralement utilisé pour un serveur POP3 sécurisé est 995 (et non 110, valeur du port par défaut).
Avant la version 28 Update 4, cette constante avait pour nom optionSSL.
Universal Windows 10 App Constante non disponible.
Remarques

Protocole POP3

  • Les différents paramètres passés à la fonction EmailOuvreSessionPOP3 sont fournis par le fournisseur de services ou par l'administrateur réseau. Avant de pouvoir gérer les emails, il est nécessaire d'ouvrir une connexion Internet. Plusieurs cas peuvent se présenter :
    • L'utilisateur utilise un modem pour se connecter à Internet : la fonction NetOuvreAccèsDistant permet d'ouvrir la connexion à Internet.
    • L'utilisateur utilise une connexion à Internet directe (cable ou ADSL) : aucune opération spécifique ne doit être faite.
  • Le protocole POP3 permet uniquement de lire des messages emails. Si vous tentez d'envoyer des messages emails sans ouvrir une session SMTP (fonction EmailOuvreSessionSMTP), une erreur du WLangage sera générée.
    Pour ouvrir à la fois une session POP3 et une session SMTP, utilisez la fonction EmailOuvreSession.
  • Les emails reçus sont ceux reçus lors de l'ouverture de la session. Tous les emails reçus après l'ouverture de la session ne sont pas accessibles. Pour accéder aux nouveaux emails reçus, il est nécessaire de fermer et de ré-ouvrir la session POP3.

Session et nom d'utilisateur

Après l'ouverture d'une session POP3, il est possible d'ouvrir une session SMTP (fonction EmailOuvreSessionSMTP) en utilisant le même nom d'utilisateur.

Délai de timeout

Il est possible de paramétrer le délai de timeout avec la fonction EmailChangeTimeOut.
Universal Windows 10 App

Fonctionnalité d'application requise

L'utilisation de cette fonction entraîne la déclaration d'une fonctionnalité d'application dans l'assistant de génération de l'application.
Fonctionnalité requise : Réseaux domestiques et professionnels
Cette fonctionnalité permet aux applications d'utiliser des accès entrants et sortants vers des réseaux domestiques et professionnels.

Gmail : Que faire si une connexion à Gmail (SMTP, IMAP, POP3) échoue avec une erreur de certificat ?

Depuis fin août 2017, Google a déployé un nouveau certificat : Google Internet Authority G3. Malheureusement, l'API Windows utilisée pour la vérification des certificats ne valide pas ce certificat.
L'ouverture d'une session POP3, IMAP ou SMTP peut donc échouer avec le retour "La chaîne de certificats a été fournie par une autorité qui n'est pas approuvée".
Afin de permettre la validation du certificat, il est possible de modifier le mode de gestion des emails. La fonction WLangage EmailParamètre permet de changer ce mode et ainsi de ne plus utiliser l'API Windows qui bloque ce certificat. Voici le code à ajouter avant l'ouverture de la session par la fonction EmailOuvreSessionPOP3 :
// Activation de l'implémentation multiplateforme
EmailParamètre(emailParamètreMode, 1)
Remarque : À partir de la version 23 Update 1, l'appel à la fonction EmailParamètre n'est plus nécessaire : le WLangage utilise automatiquement le mode de gestion des emails adapté à la session.
Liste des exemples associés :
Les fonctions Email POP3 Exemples unitaires (WINDEV) : Les fonctions Email POP3
[ + ] Utilisation des fonctions Email pour gérer le protocole POP3.
Ce protocole sert à récupérer des emails depuis un serveur.
WD JavaMail Exemples didactiques (WINDEV) : WD JavaMail
[ + ] Cet exemple est un exemple Java permettant de de lire et envoyer des emails.
Composante : wd290com.dll
Minimum version required
  • Version 9
Comments
Click [Add] to post a comment

Last update: 08/30/2023

Send a report | Local help