4D Internet Commands v14

IMAP_GetMBStatus

Accueil

 
4D Internet Commands v14
IMAP_GetMBStatus

IMAP_GetMBStatus 


 

IMAP_GetMBStatus ( imap_ID ; nomBL ; nbMsg ; nbNouvMsg ; nbMsgNonLus ; uniqueIDBL ) -> Résultat 
Paramètre Type   Description
imap_ID  Entier long in Référence de connexion IMAP
nomBL  Texte in Nom de boîte aux lettres
nbMsg  Entier long in Nombre de messages dans la boîte aux lettres spécifiée
nbNouvMsg  Entier long in Nombre de messages avec le marqueur \Recent
nbMsgNonLus  Entier long in Nombre de messages sans le marqueur \Seen
uniqueIDBL  Entier long in Numéro d’identification unique de la boîte aux lettres spécifiée
Résultat  Entier in Code d'erreur

La commande IMAP_GetMBStatus retourne le statut des paramètres de la boîte aux lettres spécifiée par nomBL. Cette commande ne modifie ni la boîte aux lettres courante (cf. IMAP_SetCurrentMB), ni le statut des messages présents dans la boîte aux lettres (en particulier, la commande ne supprime généralement pas les marqueurs \Recent, toutefois ce fonctionnement peut varier en fonction des paramétrages du serveur IMAP4). Cette commande alternative permet d’obtenir le statut des paramètres sans désélectionner la boîte aux lettres courante.

IMAP_GetMBStatus est particulièrement utile pour :

  • Tester ou récupérer le numéro d’identification unique d’une boîte aux lettres.
  • Vérifier les messages récents ou non lus d’une boîte aux lettres sans ouvrir de session spécifique.

Important : Il est fortement recommandé de ne pas utiliser la commande IMAP_GetMBStatus avec la boîte aux lettres courante. Dans ce cas en effet, il y a risque de désynchronisation des informations (concernant en particulier les nouveaux messages).

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

Le paramètre nomBL contient le nom complet de la boîte aux lettres dont vous souhaitez obtenir les paramètres de statut.

Note : A la différence de la commande IMAP_ListMBs, le paramètre nomBL n’accepte pas de caractères “Joker” avec IMAP_GetMBStatus.

Le paramètre nbMsg retourne le nombre de messages présents dans la boîte aux lettres (retourne -1 en cas d’erreur).

Le paramètre nbNouvMsg retourne le nombre de messages récents présents dans la boîte aux lettres (retourne -1 en cas d’erreur).

Le paramètre nbMsgNonLus retourne le nombre de messages non lus présents dans la boîte aux lettres (retourne -1 en cas d’erreur).

Le paramètre uniqueIDBL retourne le numéro d’identification unique de la boîte aux lettres (retourne -1 en cas d’erreur).
Avec le protocole IMAP4, le nom n’est pas suffisant pour identifier une boîte aux lettres. Pour cela, un numéro d’identification unique est attribué à chaque boîte aux lettres. Cet identifiant est particulièrement utile pour synchroniser des tâches.
Ainsi, vous pouvez vérifier si une boîte aux lettres “A” a été renommée “B” ou supprimée, simplement en vérifiant son numéro d’identification unique. De même, l’identifiant vous permet de savoir si une boîte aux lettres “A” a été supprimée puis remplacée par une nouvelle boîte nommée “A”.

 
PROPRIÉTÉS 

Produit : 4D Internet Commands
Thème : IC IMAP Review Mail
Numéro : 88879
Nom intl. : IMAP_GetMBStatus

 
HISTORIQUE 

Créé : 4D Internet Commands 6.8.1

 
VOIR AUSSI  

IMAP_GetFlags
IMAP_ListMBs
IMAP_SetCurrentMB
IMAP_SetFlags

 
UTILISATION DE L'ARTICLE

4D Internet Commands ( 4D Internet Commands v11.4)
4D Internet Commands ( 4D v13.2)
4D Internet Commands ( 4D Internet Commands v12.1)
4D Internet Commands ( 4D Internet Commands v14 R2)
4D Internet Commands ( 4D Internet Commands v14)
4D Internet Commands ( 4D Internet Commands v14 R3)
4D Internet Commands ( 4D Internet Commands v14 R4)