4D Doc Center : IMAP

4D Internet Commands v14

IMAP_CopyToMB


IMAP_CopyToMB ( imap_ID ; premierMsg ; dernierMsg ; nomBLCible ; supprMsg ) -> Résultat

Paramètre	Type	Description
imap_ID	Entier long	Référence de connexion IMAP
premierMsg	Entier long	Numéro du premier message
dernierMsg	Entier long	Numéro du dernier message
nomBLCible	Texte	Nom de la boîte aux lettres de destination
supprMsg	Entier	0 = Ne pas supprimer de la boîte aux lettres source, 1 = Supprimer de la boîte aux lettres source
Résultat	Entier	Code d’erreur

Description

La commande IMAP_CopyToMB recopie le(s) message(s) appartenant à l’intervalle premierMsg;dernierMsg à la suite des messages de la boîte aux lettres de destination nomBLCible. Les marqueurs et dates internes des messages sont généralement conservés dans la boîte aux lettres de destination, toutefois ce fonctionnement dépend de l’implémentation du serveur IMAP.

Après la copie, les messages originaux ne sont pas supprimés de la boîte aux lettres source. Si vous voulez les supprimer, vous disposez de trois solutions :

utiliser la commande IMAP_Delete,
passer la valeur 1 dans le paramètre optionnel supprMsg,
placer le marqueur IMAP_SetFlags (\Deleted) : les messages seront supprimés à la fermeture de la session.

Note : Le paramètre supprMsg force l’exécution de IMAP_Delete ; par conséquent, la suppression concernera les messages situés dans l’intervalle premierMsg;dernierMsg ainsi que TOUS les messages comportant le marqueur \Deleted.

Si la boîte aux lettres de destination n’existe pas, une erreur est retournée.

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.

nomBLCible contient le nom et le chemin d’accès de la boîte aux lettres devant recevoir les messages copiés.

Le paramètre optionnel supprMsg vous permet d’indiquer si vous souhaitez que les messages copiés soient supprimés de la boîte aux lettres source :

0= Ne pas supprimer les messages (valeur par défaut) ;
1= Supprimer les messages.

Si supprMsg est omis, la valeur par défaut est utilisée.

Si la copie échoue, le message n’est pas supprimé de la boîte aux lettres source.
Si l’utilisateur ne dispose pas d’accès suffisants pour supprimer des messages, une erreur est générée.