4D Internet Commands v16

IMAP_MsgLstInfo

Accueil

 
4D Internet Commands v16
IMAP_MsgLstInfo

IMAP_MsgLstInfo 


 

IMAP_MsgLstInfo ( imap_ID ; premierMsg ; dernierMsg ; tabTaillesMsg ; tabNumMsg ; tabIDMsg ) -> Résultat 
Paramètre Type   Description
imap_ID  Entier long in Référence de connexion IMAP
premierMsg  Entier long in Numéro du premier message
dernierMsg  Entier long in Numéro du dernier message
tabTaillesMsg  Tableau entier long in Tableau des tailles
tabNumMsg  Tableau entier long in Tableau des numéros de messages
tabIDMsg  Tableau entier long in Tableau des ID uniques
Résultat  Entier in Code d’erreur

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.



Voir aussi  

IMAP_SetCurrentMB

 
PROPRIÉTÉS 

Produit : 4D Internet Commands
Thème : IC IMAP Review Mail
Numéro : 88872

 
HISTORIQUE 

Créé : 4D Internet Commands 6.8.1

 
UTILISATION DE L'ARTICLE

4D Internet Commands ( 4D Internet Commands v16)