DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Gestion des emails
  • Nombre de messages présents dans la boîte aux lettres (protocole POP3)
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
Lit l'entête d'un email reçu :
  • soit par le protocole POP3 ou IMAP : l'email est présent dans la boîte aux lettres sur le serveur de messagerie.
Les différentes variables de la structure email correspondant à l'entête du message sont remplies.
Cette fonction est utile lorsque la lecture de l'email est par exemple liée à la taille du message.
Si aucun email n'est trouvé, la variable Email.EnDehors est positionnée à Vrai.
Rappel : Avant de lire un email, il est nécessaire d'ouvrir une session avec une des fonctions suivantes : EmailOuvreSession, EmailOuvreSessionNotes ou EmailOuvreSessionOutlook.
Exemple
// Utilisation du protocole POP3
// Lecture des emails dont la taille ne dépasse pas TailleMaxEmail
I est un entier
POUR I = 1 À EmailNbMessage(NomUser)
SI EmailTailleMessage(NomUser, I) < TailleMaxEmail ALORS
// Procédure de lecture et traitement du message
LireMessage()
SINON
EmailLitEntêteMessage(NomUser, I)
// Procédure de réponse signalant que l'email n'a pas été lu
RenvoiMessage(Email.AdresseExpéditeur)
FIN
FIN
Syntaxe

Lire l'entête d'un email géré par le protocole POP3 ou IMAP Masquer les détails

<Résultat> = EmailLitEntêteMessage(<Session> [, <Email>] , <Numéro message>)
<Résultat> : Booléen
  • Vrai si l'entête du message a été lu. Dans ce cas, la structure email est automatiquement mise à jour.
  • Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
La variable Email.EnDehors est positionnée à Vrai si aucun message n'a été trouvé (pas de mail).
<Session> : Chaîne de caractères ou variable de type emailSessionPOP3 ou emailSessionIMAP
Identifie la session d'un utilisateur. Correspond :
<Email> : Variable de type Email optionnelle
Nom de la variable de type Email à initialiser avec le contenu du message. Si ce paramètre n'est pas spécifié, la structure Email est utilisée.
<Numéro message> : Entier
Numéro du message dont l'entête doit être lu.
Remarques

Nombre de messages présents dans la boîte aux lettres (protocole POP3)

Le nombre total des messages reçus est obtenu grâce à la fonction EmailNbMessage.
Si, dans la même session d'emails, un message a été supprimé par la fonction EmailSupprimeMessage :
  • la fonction EmailNbMessage renvoie le nombre de messages présents sur le serveur d'emails avant la suppression.
  • les numéros des messages supprimés ne sont pas ré-affectés.
Par exemple : Lors de la connexion, quatre messages sont sur le serveur et ces messages sont numérotés de 1 à 4. Si le message 1 est supprimé :
  • La fonction EmailNbMessage renvoie 4.
  • La lecture du message 1 avec la fonction EmailLitMessage ou la fonction EmailLitEntêteMessage est impossible : le message n'existe plus. La variable Email.EnDehors retourne Vrai. Seuls les messages 2, 3 et 4 existent.
Les numéros des messages sont ré-affectés lors de la prochaine connexion.
Composante : wd290com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale