IMAP_Login

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

version 6.8.1


IMAP_Login (nomServeur; nomUtilisateur; motDePasse; imap_ID) Entier

ParamètreTypeDescription
nomServeurAlphaNom ou adresse IP du serveur de courrier IMAP
nomUtilisateurAlphaNom de l'utilisateur
motDePasseAlphaMot de passe
imap_IDEntier longRéférence de cette connexion IMAP
RésultatEntierCode d'erreur

Description

La commande IMAP_Login connecte l'utilisateur défini par nomUtilisateur et motDePasse au serveur de courrier IMAP.

IMAP_Login retourne un numéro d'identification spécifique pour la connexion (imap_ID) que les commandes IMAP ultérieures devront utiliser.

La connexion peut être close via la commande IMAP_Logout ou si le compteur d'inactivité du serveur IMAP a atteint le délai de timeout.

Le paramètre nomServeur contient le nom ou l'adresse IP du serveur de courrier IMAP. 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 IMAP. 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 IMAP.

Le paramètre imap_ID est une variable de type Entier long dans laquelle la référence de la connexion venant d'être établie est renvoyée. Une variable 4D doit être passée à ce paramètre afin d'accepter les résultats retournés. Cette variable devra être utilisée par toutes les commandes suivantes effectuant des actions liées à cette connexion.

Si la commande IMAP_Login échoue, imap_ID prend la valeur zéro.

Exemple

Voici une séquence type de connexion :

   $ErrorNum:=IMAP_Login (vHost;vUserName;vUserPassword;vImap_ID)
   Si($ErrorNum =0)
      C_TEXTE(vCapability)
      $ErrorNum:=IMAP_Capability (vImap_ID;vCapability))
      … ` Commandes IMAP utilisant le paramètre vImap_ID
   Fin de si
   $ErrorNum:=IMAP_Logout (vImap_ID)

Référence

IMAP_Logout, IMAP_VerifyID.


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