4D Internet Commands v14

IMAP_CopyToMB

Accueil

 
4D Internet Commands v14
IMAP_CopyToMB

IMAP_CopyToMB 


 

IMAP_CopyToMB ( imap_ID ; premierMsg ; dernierMsg ; nomBLCible ; supprMsg ) -> 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
nomBLCible  Texte in Nom de la boîte aux lettres de destination
supprMsg  Entier in 0 = Ne pas supprimer de la boîte aux lettres source, 1 = Supprimer de la boîte aux lettres source
Résultat  Entier in Code d’erreur

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.

 
PROPRIÉTÉS 

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

 
HISTORIQUE 

Créé : 4D Internet Commands 6.8.1

 
VOIR AUSSI  

IMAP_CreateMB
IMAP_ListMBs
IMAP_RenameMB

 
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)