4D Internet Commands v16

IMAP_GetMessage

Accueil

 
4D Internet Commands v16
IMAP_GetMessage

IMAP_GetMessage 


 

IMAP_GetMessage ( imap_ID ; numéroMsg ; décalage ; longueur ; partieMsg ; texteMsg {; majSeen} ) -> Résultat 
Paramètre Type   Description
imap_ID  Entier long in Référence de connexion IMAP
numéroMsg  Entier long in Numéro du message
décalage  Entier long in Caractère à partir duquel commencer la récupération
longueur  Entier long in Nombre de caractères à renvoyer
partieMsg  Entier in 0 = Message entier, 1 = En-tête uniquement, 2 = Corps uniquement
texteMsg  Texte in Texte du message
majSeen  Entier in 0 = Mettre à jour le marqueur \Seen, 1 = Ne pas le mettre à jour
Résultat  Entier in Code d’erreur

La commande IMAP_GetMessage retourne le texte du message désigné par numéroMsg dans la boîte aux lettres courante définie par la commande IMAP_SetCurrentMB. Sauf spécification contraire de la commande IMAP_SetPrefs, les caractères Retour à la ligne (Line feed) à l’intérieur du message sont supprimés.
La commande IMAP_GetMessage peut retourner soit l’intégralité du message, y compris les informations des zones d’en-tête, soit uniquement une partie du message (en-tête ou corps) en fonction de la valeur du paramètre partieMsg.

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

Le paramètre numéroMsg désigne le message à récupérer dans la boîte aux lettres. Le numéroMsg représente la position du message dans la liste courante de messages. Attention, le numéroMsg d’un message n’est pas une valeur stable, il diffère d’une session à l’autre.

Le paramètre décalage vous permet d’indiquer la position du caractère (calculée par rapport au début de la partie du message à récupérer) à partir duquel commencer la lecture. Dans la plupart des cas, vous passerez 0 (zéro) dans ce paramètre.

Le paramètre longueur indique le nombre de caractères à récupérer au-delà de la position de décalage. La longueur maximale d’une variable 4D de type Texte étant limitée à 32 000 caractères, le paramètre longueur doit être inférieur à 32 000. Les parties de messages à récupérer dont la taille est supérieure à 32 K doivent être stockés sur disque au moyen de la commande IMAP_Download.

Le paramètre partieMsg permet d’indiquer la partie du message à récupérer. Vous pouvez utiliser les valeurs 0, 1 ou 2 :

  • 0 = Message entier
  • 1 = En-tête uniquement
  • 2 = Corps uniquement (c’est-à-dire à partir du premier Text/ plain rencontré).
    Lorsque vous récupérez le message entier ou l’en-tête uniquement, vous obtenez du texte brut non décodé. Lorsque vous récupérez le corps uniquement, le texte obtenu est automatiquement décodé et converti si nécessaire (reportez-vous à la description de la commande POP3_Charset pour plus d’informations sur les règles de conversion et de décodage).

Le paramètre optionnel majSeen vous permet d’indiquer si le marqueur \Seen (“message lu”) doit être ajouté ou non aux marqueurs du message. Vous pouvez passer une des valeurs suivantes :

  • 0 = Ajouter le marqueur \Seen (valeur par défaut)
  • 1 = Ne pas ajouter le marqueur \Seen
Si vous omettez le paramètre majSeen, le marqueur \Seen est ajouté par défaut au message.

Le texte récupéré est retourné dans la variable texteMsg.



Voir aussi  

IMAP_Download
IMAP_Login
IMAP_SetCurrentMB
IMAP_SetPrefs

 
PROPRIÉTÉS 

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

 
HISTORIQUE 

Créé : 4D Internet Commands 6.8.1

 
UTILISATION DE L'ARTICLE

4D Internet Commands ( 4D Internet Commands v16)