4D Internet Commands v16
FTP_MacBinary
FTP_MacBinary
| FTP_MacBinary ( ftp_ID ; modeMacBinary ) -> Résultat | ||||||||
| Paramètre | Type | Description | ||||||
| ftp_ID | Entier long |
|
Référence d'une connexion FTP | |||||
| modeMacBinary | Entier |
|
-1 = Obtenir le paramètre courant, 1 = Activer, 0 = Désactiver | |||||
|
Paramètre courant (si -1 passé) | |||||||
| Résultat | Entier |
|
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.
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)
If($erreur=10053)
MacBinaryEstAccepte:=False `Le serveur ftp ne gère pas le protocole MacBinary
Else
MacBinaryEstAccepte:=True
End if
vFichierLocal:=""
If(MacBinaryEstAccepte)
vUtiliserMacBin:=1
$erreur:=FTP_MacBinary(vFTP_ID;vUtiliserMacBin) `Activation de MacBinary pour le téléchargement
End if
$erreur:=FTP_Receive(vFTP_ID;"MonApplication";vFichierLocal;cbShowTherm)
If($erreur=0)&(vUtiliserMacBin=1) `Si la réception est OK et le fichier est au format MacBinary
vCheminDecode:=""
If(IT_Decode(vFichierLocal;vCheminDecode;8)=0) `Décodage MacBinary
DELETE DOCUMENT(vFichierLocal) `Si le décodage a réussi, alors supprimer le fichier source
End if
End if
Produit : 4D Internet Commands
Thème : IC File Transfer
Numéro :
88938
Créé : 4D Internet Commands 6.5
4D Internet Commands ( 4D Internet Commands v16)
