NUMBER %GETFILE%
Scopo: permette di copiare localmente un
file da una locazione remota.
| Sintassi: |
| %NUMBER% |
%GETFILE% |
(%STRING% |
filedest, |
| |
|
%STRING% |
url, |
| |
|
%STRING% |
user, |
| |
|
%STRING% |
psw[, |
| |
|
%STRING%* |
header], |
| |
|
%NUMBER% |
timeout[, |
| |
|
%STRING% |
proxy, |
| |
|
%NUMBER% |
pport[, |
| |
|
%STRING% |
puser, |
| |
|
%STRING% |
ppsw[, |
| |
|
%STRING% |
lbind]]]) |
Descrizione: Utilizzata per copiare in locale, nella
webroot, un file referenziato da url.
Sono gestiti solo i protocolli HTTP e FTP.
- filedestcontiene il body della risposta HTTP o il file richiesto
via FTP (verrà creato oppure se esistente verrà sovrascritto);
- url contiene la url da eseguire;
- psw contiene la password per l'autenticazione sul server indicato in
url;
- *header è un parametro opzionale, identificato da un buffer dichiarato
precedentemente, che contiene la header HTTP della risposta;
- timeout tempo di attesa della risposta espresso in secondi;
- proxy è un parametro opzionale, gestito solo per il protocollo HTTP, che
identifica il proxy che intercede all'esecuzione della url;
- pport è un parametro opzionale, rispetto all'uso di proxy, che
identifica la porta sulla quale avviene l'autenticazione sul proxy;
- puser è un parametro opzionale, rispetto all'uso di proxy, che
identifica il nome dell'utente riconosciuto dal proxy;
- ppsw è un parametro opzionale, rispetto all'uso di proxy, che
identifica la password dell'utente puser di proxy;
- lbind è un parametro opzionale per il bind dell'indirizzo locale.
Valore restituito: valore numerico
Torna 0 in caso di operazione eseguita con successo;
Torna -1 o un codice di errore specifico, se disponibile, in caso di errore.
Vedere anche: %HTTPPOST%,
Protocolli di rete
Esempio:
%GETFILE%("c:\\temp\\locale.txt",
"ftp://pippo.pluto.net:21/pub/esempio.txt",
"anonymous","someone@somewhere",60)
Annotazioni
Il parametro lbind è disponibile
dalla versione 3.3.0.1 di Highway Application Server.