POP3_Login

4D Internet Commands v16

POP3_Login


POP3_Login ( nomServeur ; nomUtilisateur ; motDePasse ; aPOP ; pop3_ID {; paramSession} ) -> Résultat

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

Description

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