DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Gestion des emails
  • Messages supprimés (protocole POP3)
  • Messages supprimés (messagerie Outlook)
  • Messages supprimés (protocole IMAP)
  • Nouveaux messages (protocole POP 3)
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
Renvoie le nombre de messages reçus actuellement présents :
  • sur le serveur d'emails (protocole POP3 et IMAP).
    • Protocole POP3 : Ce nombre de messages reste constant durant toute la session d'emails, même si des nouveaux emails sont reçus ou si des emails sont supprimés avec la fonction EmailSupprimeMessage.
    • Protocole IMAP : Ce nombre de messages évolue en fonction des emails reçus ou réellement supprimés du serveur d'emails (via une commande "expunge", par exemple, vider la corbeille depuis un WebMail). Il est également possible de forcer la destruction de tous les emails supprimés grâce à la fonction EmailDétruit.
  • WINDEVWEBDEV - Code Serveur dans le logiciel de messagerie Outlook. Ce nombre de messages évolue en fonction des emails reçus ou supprimés avec la fonction EmailSupprimeMessage.
  • WINDEVWEBDEV - Code Serveur dans le logiciel de messagerie Notes. Ce nombre de messages évolue en fonction des emails reçus ou supprimés avec la fonction EmailSupprimeMessage.
// Boucle de lecture de tous les messages reçus présents
// dans la boîte aux lettres du protocole POP3
I est un entier
nbMSG est un entier = EmailNbMessage(NomUser)
POUR I = 1 À nbMSG
EmailLitMessage(NomUser,I)
SI Email.EnDehors <> Vrai ALORS
CL.NOM = Email.Expéditeur
CL.MESSAGE_TXT = Email.Message
...
SINON
Info("Ce message a été supprimé")
FIN
FIN
Syntaxe

Connaître le nombre d'emails présents sur le serveur d'emails (protocole POP3) Masquer les détails

<Résultat> = EmailNbMessage(<Session POP3>)
<Résultat> : Entier
  • Nombre de messages reçus sur le serveur au début de la session d'emails en cours,
  • -1 en cas d'erreur. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Session POP3> : Chaîne de caractères
Identifie la session d'un utilisateur (Protocole POP3). Ce paramètre peut correspondre à :
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)

Connaître le nombre d'emails présents sur le logiciel de messagerie Outlook Masquer les détails

<Résultat> = EmailNbMessage(<Session messagerie Outlook>)
<Résultat> : Entier
  • Nombre de messages reçus présents dans le logiciel de messagerie Outlook au moment de l'appel de la fonction EmailNbMessage,
  • -1 en cas d'erreur. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Session messagerie Outlook> : Entier ou variable de type emailSessionOutlook
Identifiant de la session email de la messagerie Outlook en cours. Ce paramètre peut correspondre à :
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)

Connaître le nombre d'emails présents sur le logiciel de messagerie Notes Masquer les détails

<Résultat> = EmailNbMessage(<Session messagerie Notes>)
<Résultat> : Entier
  • Nombre de messages reçus présents dans le logiciel de messagerie Notes au moment de l'appel de la fonction EmailNbMessage,
  • -1 en cas d'erreur. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Session messagerie Notes> : Variable de type emailSessionNotes
Identifiant de la session email de la messagerie Notes en cours.

Connaître le nombre d'emails présents sur le serveur d'emails (protocole IMAP) Masquer les détails

<Résultat> = EmailNbMessage(<Session messagerie IMAP>)
<Résultat> : Entier
  • Nombre de messages reçus sur le serveur dans la session d'emails en cours,
  • -1 en cas d'erreur. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Session messagerie IMAP> : Variable de type emailSessionIMAP
Identifiant de la session email en cours (Protocole IMAP). Cet identifiant est renvoyé par la fonction EmailOuvreSession.
Remarques

Messages supprimés (protocole POP3)

Si 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 ne sont pas ré-affectés.
Ainsi, si quatre messages sont présents sur le serveur à l'ouverture de la session, ces messages sont numérotés de 1 à 4. Si le message 1 est supprimé :
  • La fonction EmailNbMessage utilisée dans la même session renvoie toujours 4.
  • La lecture du message 1 avec EmailLitMessage est impossible car le message n'existe plus (seuls les messages 2, 3 et 4 existent).
Les numéros des messages sont ré-affectés lors de la prochaine connexion.
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)

Messages supprimés (messagerie Outlook)

Si, dans la même session d'emails, un message a été supprimé par la fonction EmailSupprimeMessage, la fonction EmailNbMessage renvoie le nombre correct de messages présents dans le dossier des emails reçus.

Messages supprimés (protocole IMAP)

Si un message a été supprimé par la fonction EmailSupprimeMessage, ce message est réellement supprimé de la session :
  • lors de la prochaine commande "expunge" (par exemple, vider la corbeille depuis un WebMail).
  • lors de l'utilisation de la fonction EmailDétruit pour forcer la destruction de tous les emails supprimés.

Nouveaux messages (protocole POP 3)

Le protocole POP3 ne permet pas de connaître et de gérer les nouveaux messages reçus durant la connexion. Pour obtenir les nouveaux messages, il est nécessaire de se déconnecter (EmailFermeSession) puis de se reconnecter (EmailOuvreSession).
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