4D Internet Commands v16

POP3_Login

Accueil

 
4D Internet Commands v16
POP3_Login

POP3_Login 


 

POP3_Login ( nomServeur ; nomUtilisateur ; motDePasse ; aPOP ; pop3_ID {; paramSession} ) -> Résultat 
Paramètre Type   Description
nomServeur  Chaîne in Nom ou adresse IP du serveur de courrier POP3
nomUtilisateur  Chaîne in Nom de l'utilisateur
motDePasse  Chaîne in Mot de passe
aPOP  Entier in 0 = Connexion texte clair, 1 = Connexion APOP
pop3_ID  Entier long in Référence à cette connexion POP3
paramSession  Entier long in 1 = Utiliser SSL, 0 ou omis = Ne pas utiliser SSL
Résultat  Entier in Code d'erreur

La commande POP3_Login connecte l'utilisateur défini par nomUtilisateur et motDePasse au serveur de courrier POP3 nomServeur. Si aPOP vaut 1, le mécanisme APOP (cf. RFC 1321) est utilisé pour la connexion. Si aPOP vaut zéro ou est vide, la connexion est effectuée normalement, avec un mot de passe en clair. POP3_Login retourne un numéro d'identification pour la connexion (pop3_ID) que les commandes ultérieures devront utiliser.

Attention : Les accès aux serveurs POP3 ne sont pas interactifs. Une fois connecté à un serveur, vous devez effectuer les actions nécessaires, puis vous déconnecter dès que possible. Un serveur POP3 déconnecte automatiquement les sessions qui restent inactives pendant un certain laps de temps. Si l'on se réfère à la RFC pour POP3, la période d'inactivité autorisée est d'environ 30 minutes. Cependant, notre expérience montre que la plupart des serveurs déconnectent les clients inactifs après un délai beaucoup plus court.

Chaque commande en interaction avec le serveur POP3 provoque la réinitialisation du compteur d'inactivité. Si le serveur interrompt votre connexion avant que vous ayez appelé POP3_Logout, toutes les suppressions que vous avez demandées sont annulées.

Le paramètre nomServeur contient le nom ou l'adresse IP du serveur de courrier POP3. Il est généralement conseillé d'utiliser le nom du serveur.

Le paramètre nomUtilisateur contient le nom de l'utilisateur du serveur de courrier POP3. Ce nom ne doit pas contenir le nom du domaine. Par exemple, dans le cas de l'adresse "jack@4d.com", le nomUtilisateur est "jack".

Le paramètre motDePasse est le mot de passe correspondant au nomUtilisateur sur le serveur de courrier POP3.

Le paramètre aPOP vous permet d'indiquer si le mécanisme APOP doit être utilisé pour la connexion. Passez 1 pour utiliser ce mécanisme APOP, ou 0 (zéro) pour effectuer la connexion par mot de passe en clair. La valeur par défaut est 0.

Le paramètre pop3_ID retourne le numéro de référence de la session. Ce numéro sera utilisé par toutes les commandes ultérieures effectuant des actions au sein de cette session.

Le paramètre optionnel paramSession vous permet d'activer le protocole SSL pour la connexion :

  • si vous passez 1, la connexion au serveur POP3 sera effectuée en SSL (mode synchrone),
  • si vous passez 0 ou omettez ce paramètre, la connexion sera effectuée en mode standard non sécurisé.



Voir aussi  

POP3_Logout

 
PROPRIÉTÉS 

Produit : 4D Internet Commands
Thème : IC POP3 Review Mail
Numéro : 88968
Nom intl. : POP3_Login

 
HISTORIQUE 

Créé : 4D Internet Commands 6.5
Modifié : 4D Internet Commands v12.1

 
UTILISATION DE L'ARTICLE

4D Internet Commands ( 4D Internet Commands v16)