IMAP_MsgLstInfo

4D - Documentation   Français   English   German   Commandes Internet de 4D, Sommaire   Commandes Internet de 4D, Index   Retour   Précédent   Suivant

version 6.8.1


IMAP_MsgLstInfo (imap_ID; premierMsg; dernierMsg; tabTaillesMsg; tabNumMsg; tabIDMsg) Entier

ParamètreTypeDescription
imap_IDEntier longRéférence de connexion IMAP
premierMsgEntier longNuméro du premier message
dernierMsgEntier longNuméro du dernier message
tabTaillesMsgTab Entier longTableau des tailles
tabNumMsgTab Entier longTableau des numéros de messages
tabIDMsgTab Entier longTableau des ID uniques
RésultatEntierCode d'erreur

Description

La commande IMAP_MsgLstInfo retourne la taille, le numéro et l'ID unique d'un ensemble de messages contenus dans la boîte aux lettres courante (définie par la commande IMAP_SetCurrentMB). Ces informations sont renvoyées dans trois tableaux, chaque élément de tableau correspondant à un message. Les tableaux passés en paramètres doivent être déclarés, en revanche leur nombre d'éléments n'a pas d'importance : la commande IMAP_MsgLstInfo les redimensionne au nombre de messages récupérés.

La commande IMAP_MsgLstInfo ne renvoie pas d'erreur si elle ne parvient pas à récupérer des informations sur un message particulier. Dans ce cas, la commande ignore le message et ne crée pas d'élément correspondant dans les tableaux. Par conséquent, si la commande réussit à lire tous les messages, le tableau tabNumMsg contiendra une suite continue de valeurs numériques séquentielles. En cas de problème, des numéros seront manquants dans la suite numérique de tabNumMsg.

imap_ID contient la référence d'une session ouverte avec IMAP_Login.

Le paramètre premierMsg désigne le numéro du premier message à examiner. Ce numéro représente la position d'un message dans la liste de tous les messages de la boîte aux lettres courante.

Le paramètre dernierMsg indique le numéro du dernier message à examiner. Ce numéro représente la position d'un message dans la liste de tous les messages de la boîte aux lettres courante.

Note : Si le paramètre premierMsg est supérieur au paramètre dernierMsg, les commandes IMAP_Delete, IMAP_MsgLstInfo, IMAP_MsgLst, IMAP_SetFlags, IMAP_GetFlags et IMAP_CopyToMB ne retournent pas d'erreur et ne font rien.

Le tableau tabTaillesMsg reçoit la taille de chaque message dont le numéro est compris entre premierMsg et dernierMsg.

Le tableau tabNumMsg reçoit les numéros de chaque message.

Le tableau tabIDMsg reçoit les ID uniques de chaque message.

Référence

IMAP_SetCurrentMB.


4D - Documentation   Français   English   German   Commandes Internet de 4D, Sommaire   Commandes Internet de 4D, Index   Retour   Précédent   Suivant