4D Internet Commands v14

FTP_MacBinary

Accueil

 
4D Internet Commands v14
FTP_MacBinary

FTP_MacBinary 


 

FTP_MacBinary ( ftp_ID ; modeMacBinary ) -> Résultat 
Paramètre Type   Description
ftp_ID  Entier long in Référence d'une connexion FTP
modeMacBinary  Entier in -1 = Obtenir le paramètre courant, 1 = Activer, 0 = Désactiver
in Paramètre courant (si -1 passé)
Résultat  Entier in Code d'erreur

La commande FTP_MacBinary active/désactive le mode MacBinary lors des transferts FTP utilisant FTP_Send ou FTP_Receive dans la session FTP courante identifiée par ftp_ID.

Le protocole MacBinary est souvent utilisé par les clients et serveurs FTP Macintosh pour faciliter le transfert de données ou de fichiers binaires contenant à la fois des data forks (parties de "données") et des resource forks (parties de "ressources").

Note à l'attention des utilisateurs Windows : Il est possible d'utiliser le protocole MacBinary pour des transferts FTP dans un environnement Windows. Toutefois, il est généralement inutile de décoder un fichier MacBinary sur un PC. Les ordinateurs à base de processeur Intel ne peuvent pas stocker des fichiers contenant une data forks et une resource fork (format Mac OS). Comme ce format est étranger à la plate-forme PC, les fichiers Mac OS contenant une resource fork risquent d'être endommagés s'ils sont enregistrés dans un format non encodé.

ftp_ID est l'identifiant de la session FTP établie avec FTP_Login.

Le paramètre modeMacBinary indique s'il faut activer ou non le mode de transfert MacBinary. Cette valeur doit être fournie en tant que variable pour que la commande puisse renvoyer l'état des transferts MacBinary après une tentative de modification.

  • 1 active le mode de transfert MacBinary.
  • 0 (zéro) désactive le mode de transfert MacBinary.
  • -1 retourne dans ce paramètre modeMacBinary le paramétrage courant du mode de transfert MacBinary (1 ou 0).

Attention : Tous les serveurs FTP ne gèrent pas le protocole MacBinary. S'il n'est pas géré, l'erreur 10053 est générée à chaque appel de la commande FTP_MacBinary, quelle que soit la valeur du paramètre modeMacBinary. Les comportements précédemment décrits ne s'appliquent alors pas.

Exemple  

Cet exemple active le protocole MacBinary avant la réception d'un fichier FTP. Si le fichier a été correctement reçu avec MacBinary activé, il est alors décodé dans son format original et le document MacBinary reçu est supprimé.

 vUtiliserMacBin:=-1
 $erreur:=FTP_MacBinary(vFTP_ID;vUtiliserMacBin)
 Si($erreur=10053)
    MacBinaryEstAccepte:=Faux `Le serveur ftp ne gère pas le protocole MacBinary
 Sinon
    MacBinaryEstAccepte:=Vrai
 Fin de si
 
 
 vFichierLocal:=""
 Si(MacBinaryEstAccepte)
    vUtiliserMacBin:=1
    $erreur:=FTP_MacBinary(vFTP_ID;vUtiliserMacBin`Activation de MacBinary pour le téléchargement
 Fin de si
 $erreur:=FTP_Receive(vFTP_ID;"MonApplication";vFichierLocal;cbShowTherm)
 Si($erreur=0)&(vUtiliserMacBin=1) `Si la réception est OK et le fichier est au format MacBinary
    vCheminDecode:=""
    Si(IT_Decode(vFichierLocal;vCheminDecode;8)=0) `Décodage MacBinary
       SUPPRIMER DOCUMENT(vFichierLocal`Si le décodage a réussi, alors supprimer le fichier source
    Fin de si
 Fin de si

 
PROPRIÉTÉS 

Produit : 4D Internet Commands
Thème : IC File Transfer
Numéro : 88938
Nom intl. : FTP_MacBinary

 
HISTORIQUE 

Créé : 4D Internet Commands 6.5

 
VOIR AUSSI  

IT_Decode

 
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)