POP3_Login

4D - Documentation   Français   English   German   Commandes Internet de 4D, Sommaire   Commandes Internet de 4D, Index   Retour   Précédent   Suivant

version 6.5


POP3_Login (nomServeur; nomUtilisateur; motDePasse; aPOP; pop3_ID) Entier

ParamètreTypeDescription
nomServeurAlphaNom ou adresse IP du serveur de courrier POP3
nomUtilisateurAlphaNom de l'utilisateur
motDePasseAlphaMot de passe
aPOPEntier0 = Connexion texte clair, 1 = Connexion APOP
pop3_IDEntier longRéférence à cette connexion POP3
RésultatEntierCode 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.

Référence

POP3_Logout.


4D - Documentation   Français   English   German   Commandes Internet de 4D, Sommaire   Commandes Internet de 4D, Index   Retour   Précédent   Suivant