Los rincones del API Win32

Transcripción

1 Ls rincnes del API Win32 WinInet y FTP Ahra ns tca cambiar de tema para centrarns en el us del prtcl FTP desde el API WinInet. Intrducción En ls artículs anterires, ns hems precupad de explicar qué es el prtcl HTTP y cóm funcina internamente. Además, hems prfundizad en cóm utilizar el API WinInet para manejar más fácilmente las peticines y respuestas de HTTP y alguns trucs práctics que ns pueden ayudar a la hra de enfrentarns a una situación real. En este artícul vams a hacer l mism, per centrándns en un prtcl muy distint: el FTP (File Transfer Prtcl, Prtcl de Transferencia de Archivs). Durante las próximas páginas vams a ver las diferencias más imprtantes entre HTTP y FTP, el md en que funcina este prtcl, y cóm utilizarl a través del API WinInet. Diferencias entre HTTP y FTP Para cmenzar de un md más sencill, y cm ya cncems el prtcl HTTP, vams a ver las principales diferencias entre ests ds prtcls: HTTP está rientad a la transmisión de archivs en frmat HTML, aunque puede utilizarse (y se utiliza) para cualquier tr frmat, siempre y cuand se pueda representar en caracteres ASCII. FTP se rienta a archivs de infrmación binaria, desde ejecutables, hasta fichers de text plan, vides, imágenes, etc., y n sól a su transmisión, sin también a la manipulación del sistema de archivs en el servidr (mdificar la estructura de directris, crear archivs, eliminarls, etc.). Desde este punt de vista, FTP es much más versátil que HTTP, ya que ns permite trabajar cn cualquier tip de archiv. HTTP es un prtcl sin estad y sin cnexión lógica, es decir: n es necesari realizar una peración de "entrada en el sistema" antes de empezar a trabajar, y n recuerda peracines anterires que hayams hech. Sin embarg, FTP es un prtcl cn cnexión y cn estad: es imprescindible realizar una peración de "entrada" (lgin) antes de cualquier tra, y se cnserva nuestr estad en el servidr. Est permite aplicar ciertas restriccines, cm permiss especiales a cierts usuaris, cuta de utilización en disc, etc. HTTP utiliza un canal físic (el scket) para la petición-respuesta. Sin embarg, FTP utiliza ds canales físics, un de cntrl y tr para dats. El canal de cntrl se utiliza del mism md que en HTTP: para enviar y recibir las peticines y respuestas del prtcl. El canal de dats es distint, ya que pr él viaja la infrmación requerida, es decir: el archiv que hems slicitad. Además, el canal de HTTP se cierra una vez terminada la petición, except cuand se usa la cabecera "Keep-Cnnectin". En una cnexión FTP, el canal de cntrl debe permanecer activ cntinuamente, mientras que el de dats se creará para cada un de ls envís que tenga que realizar. Debid a que el Pág. 1 de 20

2 canal de dats debe estar siempre abiert, ls servidres FTP cuentan cn un límite máxim de usuaris activs, ya que pdrían desbrdar la pila TCP (el númer de cnexines sckets dispnibles para enviar y recibir infrmación). Este esquema de ds canales permite que la cnexión FTP sea full-duplex, es decir: que se permite el enví y recepción de infrmación simultáneamente (mientras se utiliza el canal de dats para recibir el archiv, se pueden seguir enviand peticines pr el canal de cntrl). HTTP cuenta cn una extensión para canales segurs: HTTPS, al igual que FTP que cuenta cn SFTP (Secure FTP) para cifrar la infrmación que se envía y recibe del servidr. Sin embarg, el API WinInet sí que sprta la extensión HTTPS per n SFTP. Si quisiérams utilizar el prtcl SFTP, tendríams que ayudarns del API WinSck para la cnexión al servidr y enví de infrmación cifrada. HTTP es un prtcl anónim, es decir: el usuari que hace la petición permanece en el annimat, a excepción de la dirección IP que realiza la petición y el prgrama que se ha utilizad. Sin embarg, el prtcl FTP requiere de un usuari y cntraseña para acceder a ls recurss. Nrmalmente, este usuari y cntraseña n sn más que la cuenta del sistema dnde residen ls archivs a acceder. Opcinalmente, se dispne del usuari annymus que funcina cm usuari general, utilizand cm cntraseña pcinal el dmin desde el que realizams la cnexión, la dirección de crre electrónic. Lógicamente, el acces a través del lgin annymus está much más restringid que el de trs usuaris. El servidr HTTP envía la infrmación requerida dentr de la misma respuesta. En la respuesta de FTP, sól se incluyen dats infrmativs, y n ls prpis dats que hems pedid. Est es debid a las ds cnexines que ya hems cmentad: una de cntrl (para las peticines y respuestas) y tra de dats (para la transferencia de ls dats el archiv que hems pedid al servidr). HTTP se basa en la recmendación MIME para manejar ls tips de archivs, pr l que se abre un ampli abanic de psibilidades. Sin embarg, FTP sól puede transferir cuatr tips de archiv: ASCII, binari, lcal, EBCDIC. De tdas frmas, cn ls tips ASCII y binari se cubren tds ls tips de archivs psibles. Para simplificar su us, el prtcl HTTP culta tdas las características de la transmisión física. En el prtcl FTP se permite cnfigurar este aspect, pudiend utilizar un de ls siguientes mds de transmisión: "de blque", "cmprimid" y "de fluj". Pr debaj del prtcl HTTP sól cntams cn el prtcl prpi de transmisión, es decir: TCP, sin embarg, en FTP se utiliza el prtcl TELNET para el enví de dats pr la cnexión de cntrl y ests, a su vez, utilizan TCP para el enví físic. Pág. 2 de 20

3 Peticines de FTP Al igual que el prtcl HTTP, el FTP se basa en el típic esquema cliente/servidr. El cliente se cnecta a una máquina remta (servidr) dnde está ejecutándse un sftware especial (el servidr FTP). Una vez establecida la cnexión, se inicia una cnversación entre las ds máquinas, basada en el esquema petición - respuesta: el cliente hace una petición y el servidr cntesta cn una respuesta. Además, ciertas respuestas pueden llevar asciadas una transmisión de infrmación, que se transmitirá pr un canal de dats cread para tal efect. Las peticines hechas pr un cliente FTP n sn más que cmands, al más pur estil MS-DOS Unix. Una palabra clave define el cmand y ls parámetrs definen sbre qué bjets actúa cóm debe cmprtarse. Pr ejempl, sabems que para cambiar de directri actual en MS-DOS Unix hay que utilizar el cmand: cd [nuev directri] Así que en FTP se hará de un md parecid, simplemente cambiand el nmbre del cmand: CWD [nuev directri] Ls cmands de FTP sn de 3 ó 4 letras en mayúsculas, seguids de un espaci y ls parámetrs que crrespnda. En la siguiente tabla tenéis una lista de alguns de ls cmands definids: Cmand USER [nmbre de usuari] PASS [cntraseña] ABOR QUIT PORT CWD [nuev directri] CDUP MKD [nmbre directri] RMD [nmbre directri] DELE [nmbre de archiv] RNFR [nmbre de archiv] RNTO [nuev nmbre archiv] SIZE [archiv] LIST [archiv directri] NLST [directri] NOOP APPE [nmbre de Descripción Identifica a un usuari en el servidr FTP Cntraseña del usuari pasad cn USER. Debe ir precedid de un cmand USER. Cancela la peración que esté prcesándse, y la transmisión que pueda estar ejecutándse en el canal de dats. Cierra la cnexión cn el servidr. Especifica el puert del cliente dnde se realizará la cnexión de dats. Cambia el directri activ. Cambia al directri padre (igual que "cd.." en MS-DOS Unix). Crea un nuev directri. Elimina un directri. Brra un archiv en la estructura de directris del servidr. Renmbrar un archiv. Este cmand indica el nmbre de archiv a renmbrar y debe estar seguid pr el cmand RNTO. Cambia el nmbre del archiv indicad cn el cmand RNFR y l establece al nmbre pasad en este parámetr. Retrna el tamañ (en bytes) del archiv remt. Muestra una lista de ls archivs en el directri actual (si n se ha pasad ningun parámetr), en el directri pasad pr parámetr (si es un directri), bien muestra infrmación del archiv pasad pr parámetr (si es un archiv). Muestra una lista de archivs en el directri pasad, en el directri activ si n se pasa ningun. Este es un cmand dummy que para l únic para l que sirve es para que el servidr respnda cn un mensaje de OK. Se utiliza para asegurarns que la cnexión está activa y funcinand. Añade el cntenid de un archiv lcal al final de un ficher remt. Pág. 3 de 20

4 archiv] RETR [nmbre de archiv] STOR [nmbre de archiv] Inicia la descarga de un ficher remt. Inicia el enví al servidr de un ficher lcal. Una vez que el cmand ha sid ejecutad, se retrna un códig de errr, seguid de un mensaje descriptiv. Además, si la peración requiere de una transferencia de infrmación, se crea el canal de dats para ell. Códigs de retrn Ls códigs retrnads pr ls cmands tienen tres dígits, cada un de ls cuales tiene un significad. El significad de ests tres dígits va de más genéric a más cncret: 1. Primer dígit: hace referencia al éxit fracas de la peración. Además indica quién es el causante del psible errr, cn ls siguientes códigs: 1xx: El servidr ha iniciad crrectamente la ejecución del cmand. 2xx: El servidr ha terminad crrectamente la ejecución del cmand. 3xx: El servidr ha recibid crrectamente el cmand, per se necesitan más dats para cmenzar la ejecución. 4xx. El servidr ha recibid el cmand per n es crrect. Se cntinúa cn la ejecución. 5xx: El servidr ha recibid el cmand per es erróne. N se puede cntinuar cn la ejecución. 2. Segund dígit: hace referencia al aspect causante del éxit fracas. Se utilizan ls siguientes códigs: x0x: Sintaxis. x1x: Slicitud de infrmación, estad ayuda. x2x: Cnexión de cntrl de dats. x3x: Prces de inici de sesión. x4x: Reservad. x5x: Sistema de archivs. 3. Identifica distints errres, agrupads según ls significads del dígit un y ds. Pág. 4 de 20

5 Cmbinand ests dígits se cnsigue una serie de errres, alguns de ls cuales pdéis ver en la siguiente tabla: Códig Descripción 101 Se reinicia la respuesta del cmand. 120 El servici estará list en X minuts. 125 Cnexión de dats abierta. Se inicia la transferencia. 200 Cmand crrect. 202 Cmand n sprtad. 211 Infrmación sbre el estad del sistema. 212 Infrmación sbre el sistema de archivs. 213 Infrmación sbre el archiv. 214 Mensaje de ayuda infrmación. 221 Se va a cerrar la cnexión de cntrl. 225 La cnexión de dats está abierta, per n hay ninguna transferencia en curs. 226 Se va a cerrar la cnexión de dats. Transferencia terminada crrectamente. 227 Entra en md pasiv. 230 El usuari ha iniciad la sesión. 250 Petición de archiv crrecta. 257 Archiv directri cread crrectamente. 331 Nmbre de archiv crrect. Tdavía falta la cntraseña. 425 N se puede abrir la cnexión de dats. 426 Transferencia abrtad y cnexión cerrada 450 El archiv slicitad n existe. 452 Espaci libre en disc insuficiente. 500 Errr de sintaxis, cmand n recncid. 501 Errr de sintaxis en ls parámetrs. 502 Cmand n implementad. 503 Secuencia de cmands incrrecta. 504 Cmand n implementad cn el parámetr pasad. 530 Sesión n iniciada. 532 Se necesita una cuenta para almacenar archivs. 552 Cuta de espaci en disc agtada. 553 Nmbre de archiv incrrect. Pág. 5 de 20

6 Mds del FTP: activ vs. pasiv Una cnexión FTP puede funcinar de ds mds: activ (el md pr defect) y pasiv (cncid cm passive mde). Para entender cóm funcinan ests mds, debems prfundizar un pc más en el esquema cliente/servidr y explicar cóm se realiza pas a pas una cnexión entre la máquina cliente y servidra. Para entender ls siguientes pass, debems cmprender un cncept muy imprtante del prtcl TCP/IP: el cncept de puert. Un puert es un identificadr de cnexión remta. N es más que un númer, e identifica la cnexión de tal md que para cnectarns a una máquina remta, debems utilizar un puert que esté libre. Nrmalmente, se admiten númers de puert desde 1 hasta 65535, y ls 1024 primers están reservads para el sistema (est depende el sistema perativ). Cuand ns cnectams a una máquina remta, debems indicar la dirección nmbre de la máquina (dirección IP y nmbre de dmini) y el númer de puert del servidr (el identificadr de nuestra cnexión). De este md, cuand llega un dat a la máquina remta, sabe perfectamente a qué cnexión pertenece dich dat. Pensad que si n existiera el puert, una máquina sól pdría atender una cnexión remta simultáneamente, prque n sería capaz de diferenciar ls dats de las distintas cnexines. Tant el cliente cm el servidr deben tener un puert activ durante la cnexión. Nrmalmente, el que inicia la cnexión (cliente) decide el puert del servidr al que quiere cnectarse y es el sistema el que asigna un númer de puert libre para el cliente. Esper que cn esta pequeña intrducción quede clar el cncept. Ahra vams allá cn ls pass de una cnexión típica en FTP. 1. El cliente arranca e intenta cnectarse cntra el servidr. Para ell crea en canal de cntrl estableciend una cnexión física a la dirección IP ( nmbre de dmini) del servidr, y desde cualquier puert del cliente (puert X) hacia el puert 21 del servidr. 2. Una vez que está establecida la cnexión, se envía el cmand PORT al servidr, para especificar el númer de puert que debe utilizar el servidr para crear la cnexión de dats (puert Y). 3. Para ciertas peracines, es necesari realizar el enví de un ficher, pr l que se crea el canal de dats. Para ell el servidr crea una cnexión física desde su puert 20 hasta un númer de puert del cliente. Este númer de puert fue el que indicó el cliente a través del cmand PORT (puert Y). De este md, el servidr establece el canal de dats pr el que se transmite la infrmación. Este esquema que hems vist es el denminad md activ, prque es el servidr el que activamente crea el canal de dats. En la Figura 1 pdéis ver un esquema de cóm y quién realizan las cnexines. Figura 1 Pág. 6 de 20

7 A cntinuación vams a ver el md pasiv y s daréis cuenta de la principal diferencia: 1. El cliente arranca e intenta cnectarse cntra el servidr. Para ell crea en canal de cntrl estableciend una cnexión física a la dirección IP ( nmbre de dmini) del servidr, y desde cualquier puert del cliente (puert X) hacia el puert 21 del servidr. (este punt es igual que en el md activ). 2. El cliente envía el cmand PASV para activar el md pasiv. Cm respuesta a este cmand, el servidr retrna un númer de puert que tenga dispnible (puert Z). 3. Para ciertas peracines, es necesari realizar el enví de un ficher, pr l que se crea el canal de dats. Para ell el cliente crea una cnexión física desde un de sus puert (puert Y) hasta un númer de puert del cliente. Este númer de puert fue el que indicó el servidr cm respuesta del cmand PASV (puert Z). De este md, el cliente establece el canal de dats pr el que se transmite la infrmación. Cm habréis vist, la principal diferencia es que en el md pasiv es el cliente el que inicia las cnexines y nunca el servidr. En la Figura 2 pdéis ver un esquema de este md de cnexión: Figura 2 Est, aunque parezca un detalle sin imprtancia, puede ser vital en algunas situacines. Supngams que nuestra cnexión a internet utiliza un crtafuegs (hy en día alg muy recmendable). El principal cmetid del crtafuegs es cerrar ls puerts para cnexines entrantes, es decir: que sbre cierts puerts sea impsible realizar una cnexión remta. Si el cliente FTP utiliza un crtafuegs, y se utiliza el md activ de cnexión, tendrems muchas psibilidades de que n funcine crrectamente, ya que cuand el servidr necesite abrir el canal de dats, se pdría utilizar un de ls puerts que el crtafuegs mantiene cerrad. Sin embarg, en el md pasiv, un crtafuegs n supne ningún prblema, ya que las cnexines siempre las inicia el cliente, y el servidr nunca intentará abrir una cnexión cn el cliente. Así que, sabiend est, es muy recmendable (pr n decir imprescindible) utilizar el md pasiv si tenems alguna sspecha de que puede haber sus crtafuegs en nuestra cnexión, si vems que hay algún tip de errr en la cnexión FTP. Pág. 7 de 20

8 FTP desde WinInet Hasta ahra sól hems vist aspects teórics del prtcl FTP, que ns van a servir para tener una idea más exacta de l que curre cuand utilizams en API WinInet. A partir de ahra vams a centrarns en las funcines de WinInet que debems utilizar para implementar un cliente FTP. Estas funcines, a su vez, manejan tds ls aspect del prtcl tal y cm hems explicad, facilitándns el trabaj a ls prgramadres. Alguns de ls pass a dar ya ls hems explicad, ya que sn cmunes cn ls pass del prtcl HTTP. Apertura de la instancia Cm ya sabems, el primer pas que debems hacer a la hra de trabajar cn WinInet es llamar a la función InternetOpen. N vy a explicar esta función prque ya hems prfundizad en ella en el artícul sbre WinInet y HTTP ( Td l dich allí ns vale para ahra, así que s anim a que deis un repas a ese artícul. Cnexión cn el servidr Este pas también l cncems, ya que l explicams en prfundidad en el artícul Más sbre WinInet y http ( cuand hablams del métd detallad de cnexión para HTTP y la función InternetCnnect. En nuestr cas, el únic cuidad que debems tener es pasar ls valres crrects a ls siguientes parámetrs: npuert: se debe pasar el valr numéric del puert en el que está escuchand el servidr FTP. Nrmalmente se utiliza el puert 21 (en la cnstante INTERNET_DEFAULT_FTP_PORT), aunque el administradr del servidr pdría haber cnfigurad cualquier tr puert. dwprtcl: indica el prtcl a utiliza en la cnexión, en nuestr cas debe ser el valr INTERNET_SERVICE_FTP. dwopcines: para cnexines FTP cntams cn la pción INTERNET_FLAG_PASSIVE, que ns permiten realizar una cnexión pasiva al servidr (tal y cm ya hems explicad). Este valr es muy recmendable si la cnexión se realiza a través de un firewall servidr prxy. Cm vems, n sn muchs ls aspects a tener en cuenta a la hra de llamar a InternetCnnect para la cnexión FTP. Una vez que hems establecid la cnexión, ya pdems empezar a trabajar cn el sistema de archivs del servidr, l que básicamente se traduce en: Manipular la estructura de directris Obtener infrmación de archivs y carpetas Manipulación de archivs Descarga y enví de archivs Ejecutar cmands genérics Pág. 8 de 20

9 Manipular la estructura de directris El equip remt tendrá una estructura de directris cm cualquier sistema perativ, en la cual ns pdrems mver y manipular. Cm en UNIX y MS-DOS, siempre estarems situads en un directri activ, en el cual se ejecutarán tdas las peracines que realicems. Pdems averiguar cual es nuestr directri activ a través de la función FtpGetCurrentDirectry: functin FtpGetCurrentDirectry( hcnexión: HINTERNET; lpszdirectriactiv: PChar; var lpdwlngituddirectri: DWORD ): LngBl; hcnexión: un descriptr de cnexión btenid a través de InternetCnnect. lpszdirectriactiv: un punter a una cadena en la que se almacenará la ruta absluta del directri activ. Hay que tener en cuenta que ls servidres FTP utilizan el separadr de UNIX ( / ) y n la barra invertida de Windws ( \ ). lpdwlngituddirectri: un punter a un valr de 32 bits en el que se pasa la lnguitud máxima de la cadena lpszdirectriactiv. Cuand la función retrna, en este valr se almacena el númer de caracteres cpiads. La función retrnará TRUE FALSE dependiend del éxit fracas. Cm es lógic, además de averiguar el directri activ, también pdrems cambiar este directri activ, a través de la función SetCurrentDirectry: functin FtpGetCurrentDirectry( hcnexión: HINTERNET; lpsznuevdirectri: PChar ): LngBl; hcnexión: un descriptr de cnexión btenid a través de InternetCnnect. lpsznuevdirectri: un punter a una cadena en la que se almacenará la ruta (absluta relativa) del nuev directri activ. La función retrna TRUE si ha tenid éxit FALSE en cas de errr. En cas de retrnar errr, una de las psibles causas es que n tenems permiss para acceder a dich directri. En tal cas, pdems hacer us de la función InternetGetLastRespnseInf (de la que ya hablams en el artícul WinInet y http - para btener el códig de errr retrnad pr el servidr. Si en un mment dad querems crear un nuev directri, debems hacerl a través de la función FtpCreateDirectry, cn la siguiente sintaxis: functin FtpCreateDirectry( hcnexión: HINTERNET; lpsznmbredirectri: PChar ): LngBl; hcnexión: un descriptr de cnexión btenid a través de InternetCnnect. lpsznuevdirectri: un punter a una cadena en la que se indica la ruta (absluta relativa) del directri a crear. Para dar el nmbre a la carpeta hay que tener en cuenta las nrmas del sistema de archivs del servidr, nrmalmente UNIX Windws. La función retrna TRUE FALSE. Pdrems llamar, cm ya hems dich, a la función InternetGetLastRespseInf para averiguar el códig y text del mensaje de errr retrnad pr el servidr. Pág. 9 de 20

10 Y lógicamente, también se pdrá brrar un directri (y td su cntenid) a través de la siguiente función: functin FtpRemveDirectry( hcnexión: HINTERNET; lpszdirectri: PChar ): LngBl; hcnexión: un descriptr de cnexión btenid a través de InternetCnnect. lpszdirectri: un punter a una cadena en la que se indica la ruta (absluta relativa) del directri a brrar. Es imprtante saber que n pdems brrar el directri si es nuestr directri activ, pr l que es recmendable hacer una llamada a FtpSetCurrentDirectry antes de realizar el brrad. Esta función, cm el rest, retrnará TRUE FALSE dependiend del éxit fracas. Obtener infrmación de archivs y carpetas Otr tip de peracines que pdems realizar cn el prtcl FTP es la btención de infrmación de archivs y carpetas remts. La única infrmación que pdems btener de un archiv es su tamañ, a través de la función FtpGetFileSize. Per antes de llamar a esta función, es necesari btener un descriptr de un archiv remt, a través de la función FtpOpenFile: functin FtpOpenFile( hcnexión: HINTERNET; lpszarchiv: PChar; dwtipacces: LngWrd; dwopcines: LngWrd; dwcntext: LngWrd ): HINTERNET; hcnexión: un descriptr de cnexión btenid a través de InternetCnnect. lpszarchiv: un punter a una cadena en la que se pasa la ruta (absluta relativa) del archiv que querems abrir. dwtipacces: el tip de acces que se va utilizar cn ficher. Se puede utilizar el valr GENERIC_READ GENERIC_WRITE. dwopcines: las pcines de acces al ficher, desde el punt de vista de el tip de transmisión: FTP_TRANSFER_TYPE_ASCII: utiliza el tip de transferencia ASCII prpia de ls servidres FTP. FTP_TRANSFER_TYPE_BINARY: utiliza el tip de transferencia binaria prpia de ls servidres FTP. FTP_TRANSFER_TYPE_UNKNOWN: igual que FTP_TRANSFER_TYPE_ASCII. INTERNET_FLAG_TRANSFER_ASCII: utiliza cdificación ASCII estándar. INTERNET_FLAG_TRANSFER_BINARY: utiliza cdificación binaria estándar. Pág. 10 de 20

11 Y desde el punt de vista del caché intern se puede cnfigurar ls siguientes aspects: INTERNET_FLAG_HYPERLINK: fuerza a cargar si n hay dats sbre la caducidad la última mdificación. INTERNET_FLAG_NEED_FILE: guarda el cntenid en un archiv tempral si n ha pdid guardarse en el caché intern. INTERNET_FLAG_RELOAD: vuelve a descargar el archiv, aunque esté en el caché. dwcntext: el valr de cntext que querams pasar al llamar a la función de callback. La función retrna el descriptr del archiv si td ha id crrectamente, NULL si ha currid algún tip de errr. Se puede llamar a GetLastErrr para averiguar las causas del errr. Cuand ya n necesitems más el descriptr de archiv, debems llamar a InternetClseHandle para cerrarl. Entre la llamada a FtpOpenFile e InternetClseHandle, n pdems llamar a ninguna tra función de WinInet, utilizand el mism descriptr de cnexión, ya que el canal de cntrl permanece cupad. Si hacems una llamada a tra función (pr ejempl FtpCreateDirectry cualquier tra) cn la misma cnexión, btendrems el errr ERROR_FTP_TRANSFER_IN_PROGRESS. Una cnsecuencia de est es que sól pdems mantener abiert un archiv pr cada cnexión FTP. Ahra que ya sabems cóm btener un descriptr de archiv cn FtpOpenFile, pdems explicar el md de utilizar la función FtpGetFileSize: functin FtpGetFileSize( harchiv: HINTERNET; lpdwtamañhigh: ^LngWrd ): LngWrd; harchiv: un descriptr de archiv btenid a través de FtpOpenFile. lpdwtamañhigh: un punter a un valr de 32 bits en el que se almacenarán ls 32 bits más alts del tamañ ttal del archiv. En cas de que el tamañ del archiv pueda almacenarse en un espaci de 32 bits (mens de 2 GB.), en este valr n se cpiará nada. La función retrnará ls 32 bits más bajs del tamañ de archiv que pueden cmbinarse cn el parámetr lpdwtamañhigh para btener un valr de 64 bits cn el tamañ ttal del archiv. Para aquells que n hayáis trabajad nunca a nivel de bits, vams a hacer una pequeña pausa para explicar el md de cmbinar ambs valres, a través de ls peradres de desplazamient de bits. En nuestr cas, desplazarems 32 bits a la izquierda el valr high y haciend un r lógic cn el valr lw, más mens del siguiente md: 1. Pas 0: valres cn ls que vams a trabajar: High: Decimal: Binari: Lw: Decimal: Binari: Ttal: Decimal: Binari: Pas 1: desplazar el valr high 32 bits a la izquierda (se crea un valr de 64 bits). Al desplazar un númer de bits a la izquierda, se rellena ls espaci sbrantes cn cers desplazad 32 bits da: Pág. 11 de 20

12 3. Pas 2: cmbinar cn el valr high cn el valr lw, a través de un peración r lógica. Cm sabéis, la peración r lógica ns retrnará 1 cuand algun de ls perands sea 1. High: r Lw: Ttal: Decimal: Cm veis, a partir de ds valres de 32 bits, se ha cread tr de 64 bits que cntiene ambs, en la parte alta y baja. Fácil verdad? De tdas frmas, esta misma peración que hems realizad a nivel de bits, se puede realizar aritméticamente más fácilmente, aplicand la siguiente ecuación: ttal = (high * ) + lw; El valr se btiene de sumar 1 al valr máxim para un rang de 32 bits. Estas ds pcines, en nuestrs lenguajes de prgramación se puede implementar muy fácilmente: var SizeHigh: integer; SizeLw: integer; ttal: Int64; { un numéric de 64 bits!! } begin ttal := (SizeHigh shl 32) r SizeLw; { a nivel de bits } ttal := (SizeHigh * ($FFFFFFFF + 1)) + SizeLw; { aritmeticamente } Buen, después de esta pequeña interrupción (que esper que s haya servid para entender alg más las peracines a nivel de bits) vams a retmar el tema que ns cupa. Ns quedams en la btención de infrmación de ls archivs y carpetas del servidr. Ya sabems que la única infrmación que se puede btener de un archiv es su tamañ, cn la función FtpGetFileSize. Para utilizar esta función debems btener un descriptr de archiv a través de FtpOpenFile, y a su vez, para llamar a esta debems cncer el nmbre del archiv al que querems acceder. Y cóm sabems el nmbre de ls archivs que tiene el servidr? Pues aquí es dnde enlazams cn l siguiente: btener infrmación de las carpetas. Básicamente, la infrmación que pdems btener de una carpeta es un listad de ls archivs y tras carpetas que cntiene. Para ell debems hacer us de ds funcines: FtpFindFirstFile para iniciar la búsqueda e InternetFindNextFile para recrrer la lista de resultads. Vams allá: functin FtpFindFirstFile( hcnexión: HINTERNET; lpszarchiv: PChar; var lpdats: WIN32_FIND_DATA; dwopcines: LngWrd; dwcntext: LngWrd ): HINTERNET; hcnexión: un descriptr de cnexión btenid a través de InternetCnnect. lpszarchiv: un punter a una cadena en la que se pasa el nmbre de archiv a encntrar. En este parámetr se puede pasar el valr NULL, para btener un listad de tds el cntenid del directri activ, bien utilizar ls cmdines que tds cncems: * y?. Si se pasa un nmbre de archiv, una máscara cn cmdines, se puede pasar tant la ruta absluta cm relativa. lpdats: un punter a una estructura de tip WIN32_FIND_DATA en la que se almacena ls dats del archiv encntrad. La estructura tiene ls siguientes camps. Pág. 12 de 20

13 WIN32_FIND_DATA = recrd dwfileattributes: LngWrd; ftcreatintime: FILETIME; ftlastaccesstime: FILETIME; ftlastwritetime: FILETIME; nfilesizehigh: LngWrd; nfilesizelw: LngWrd; dwreserved0: LngWrd; dwreserved1: LngWrd; cfilename: array[0..259] f char; calternatefilename: array[0..13] f char; Ests camps tienen ls siguientes significads: dwfileattributes: indica ls atributs que tiene asignads el archiv encntrad. Este valr es una máscara de bits en la que pueden aparecen ls siguientes valres:! FILE_ATTRIBUTE_ARCHIVE: indica que se debe marcar cm archivad.! FILE_ATTRIBUTE_COMPRESSED: indica que ls dats están cmprimids (sól valids para sistemas de archivs NTFS).! FILE_ATTRIBUTE_HIDDEN: el archiv está cult.! FILE_ATTRIBUTE_NORMAL: n tiene trs atributs asignads.! FILE_ATTRIBUTE_READONLY: el archiv está marcad cm sól lectura.! FILE_ATTRIBUTE_SYSTEM: el archiv es de sistema.! FILE_ATTRIBUTE_TEMPORARY: el archiv se ha marcad cm tempral. ftcreatintime: fecha en que se creó el archiv. ftlastaccesstime: fecha de últim acces al archiv. ftlastwritetime: fecha de la última mdificación de archiv. nfilesizehigh: 32 bits más alts del tamañ del archiv. nfilesizelw: 32 bits más bajs del tamañ del archiv. dwreserved0 y dwreserved1: n se usan. cfilename: el nmbre cmplet del archiv. calternamefilename: el nmbre crt del archiv, cn un máxim de 8 caracteres para el nmbre y 3 para la extensión. dwopcines: cnfigura el cmprtamient de la función. Pueden utilizarse cualquier cmbinación de ls siguientes valres. INTERNET_FLAG_HYPERLINK: fuerza a cargar si n hay dats sbre la caducidad la última mdificación. INTERNET_FLAG_NEED_FILE: guarda el resultad de la búsqueda en un archiv tempral si n ha pdid guardarse en el caché intern. Pág. 13 de 20

14 INTERNET_FLAG_RELOAD: vuelve a descargar el resultad de la búsqueda, aunque esté en el caché. INTERNET_FLAG_NO_CACHE_WRITE: n almacena el resultad de la búsqueda en el caché lcal. dwcntext: el valr de cntext que querams pasar al llamar a la función de callback. La función retrna un descriptr de búsqueda, que ns servirá para las siguientes llamadas a InternetFindNextFile. En cas de errr, la función retrna NULL y en este cas, pdems llamar a GetLastErrr para averiguar la causa del errr. Os recuerd, cm ya sabéis tds, que si GetLastErrr retrna ERROR_INTERNET_EXTENDED_ERROR, debems llamar a la función InternetGetLastRespnseInf para cnseguir más dats sbre el errr. Una vez cnseguid el descriptr de la búsqueda (el valr retrnad pr FtpFindFirstFile), la estructura WIN32_FIN_DATA tendrá ls valres del primer archiv que cumpliese el criteri de búsqueda. Si querems buscar el siguiente archiv, debems hacer us de la función InternetFindNextFile. Os habréis fijad que esta función n empieza pr Ftp sin pr Internet. Hace ya uns cuants meses, en el artícul Intrducción al API WinInet, dijims que las funcines cmenzaban pr el nmbre del prtcl cn el que trabajaban (Http, Ftp Gpher) except las que cmenzaban pr Internet, que eran para us general servían para varis prtcls. Este es el cas de InternetFindNextFile, que sirve tant para una cnexión FTP cm Gpher. Cm n explicarems el prcl Gpher, sól explicaré el us de esta función aplicada al prtcl FTP. La sintaxis es la siguiente: functin InternetFindNextFile( hbúsqueda: HINTERNET; lpvdats: Pinter ): LngBl; hbúsqueda: un descriptr de búsqueda cnexión btenid a través de FtpFindFirstFile. lpdats: un punter a una estructura de tip WIN32_FIND_DATA en la que se almacena ls dats del archiv encntrad. En realidad este valr es un punter genéric, per para cnexines FTP debe pasarse un punter a esta estructura. La función retrna TRUE FALSE dependiend del éxit errr. Cuand retrne FALSE, debe cmprbarse el valr de GetLastErrr, y si retrna el valr ERROR_NO_MORE_FILES significará que n se han encntrad más archivs que cumpliesen la cndición de búsqueda. Sabiend est, el us más típic de estas funcines es el que aparece a cntinuación: Pág. 14 de 20

15 var dats: WIN32_FIND_DATA; busqueda: HINTERNET; k: blean; begin busqueda := FtpFindFirstFile(hCnexin, 0, 0); try k := (busqueda <> nil); while k d begin { aquí se prcesa el archiv encntrad } k := if GetLastErrr() <> ERROR_NO_MORE_FILES then MessageBx(GetActiveWindw(), 'Errr buscand archivs en FTP.', 'Errr', MB_ICONERROR); finally if busqueda <> nil then InternetClseHandle(busqueda); Manipulación de archivs Antes de llegar a l realmente imprtante (descarga y enví de archivs), l últim que ns queda pr ver antes es la manipulación de archivs: renmbrad y brrad de archivs. El renmbrad de un archiv remt se hace a través de la función FtpRenameFile: functin FtpRenameFile( hcnexión: HINTERNET; lpsznmbreactual: PChar; lpsznmbrenuev: PChar ): LngBl; hcnexión: un descriptr de cnexión btenid a través de InternetCnnect. lpsznmbreactual: un punter a una cadena en la que se pasa el nmbre del archiv que querems renmbrar. El nmbre de archiv puede incluir la ruta, absluta relativa. Si n se indica alguna ruta, se buscará el archiv en el directri activ. Además de archivs, esta función admite el renmbrad de directris, pr l que en este parámetr se puede pasar tant un nmbre de archiv cm de directri. lpsznmbrenuev: un punter a una cadena en la que se pasa el nuev nmbre que querems darle al archiv directri. Este nmbre, al igual que cn el anterir parámetr, puede incluír la ruta absluta relativa del nuev nmbre. Si esta ruta es distinta a la ruta especificada en el nmbre riginal ( el directri activ si n se especificó ninguna), el archiv, además de ser renmbrad, se mverá al directri que indiquems. Es pr est que esta función, además de renmbrar archivs, sirve para mverls de directri. Esta función retrna TRUE si td ha id bien, FALSE en cas de errr. Pág. 15 de 20

16 Además de renmbrar mver un archiv, pdems eliminarl a través de la función FtpDeleteFile: functin FtpDeleteFile( hcnexión: HINTERNET; lpsznmbrearchiv: PChar ): LngBl; hcnexión: un descriptr de cnexión btenid a través de InternetCnnect. lpsznmbrearchiv: un punter a una cadena en la que se pasa el nmbre del archiv que querems eliminar. Opcinalmente, se puede incluir la ruta absluta relativa del archiv. Esta función, cm tras muchas, retrna TRUE FALSE. Descarga y enví de archivs Cm es lógic, la tarea más imprtante a la hra de cnectarse a un servidr FTP es la descarga y enví de archivs, y ahra que ya sabems renmbrar, mver y eliminar archivs, pdems centrarns en esta parte del prtcl FTP. Tant la descarga cm en enví pdems realizarls de ds frmas, una directa (cn una única llamada a una función) y tra al estil de la lectura de archivs lcales: cn apertura, lectura y cierre del ficher. La descarga cn el métd direct puede hacerse a través de la función FtpGetFile: functin FtpGetFile( hcnexión: HINTERNET; lpszarchivremt: PChar; lpszarchivlcal: PChar; ferrrsiexiste: LngBl; dwatributs: LngWrd; dwopcines: LngWrd; dwcntext: LngWrd ): LngBl; hcnexión: un descriptr de cnexión btenid a través de InternetCnnect. lpszarchivremt: un punter a una cadena en la que se pasa el nmbre del archiv remt que querems descargar. Se puede incluir la ruta absluta relativa. lpszarchivlcal: un punter a una cadena en la que se pasa el nmbre del archiv lcal dnde se almacenará el cntenid del archiv remt. Se puede incluir la ruta absluta relativa. ferrrsiexiste: indica si la función fallará si el archiv lcal ya existe, si el archiv lcal debe ser sbrescrit. dwatributs: indica el cnjunt de atributs que se establecerá al archiv lcal. Se puede incluír cualquier valr de ls admitids pr el atributs dwfileattributes, dentr de la estructura WIN32_FIND_DATA (que ya hems explicad anterirmente). dwopcines: indica el cnjunt de pcines que cntrlan la descarga del archiv. Se puede utilizar cualquier cmbinación de ls valres que explicams para el parámetr dwopcines de la función FtpOpenFile. dwcntext: el valr de cntext que querams pasar al llamar a la función de callback. La función retrna TRUE FALSE, dependiend de su éxit fracas. Pág. 16 de 20

17 Pr el tr lad, pdems realizar en enví de un ficher a un servidr FTP a través de la función FtpPutFile: functin FtpPutFile( hcnexión: HINTERNET; lpszarchivlcal: PChar; lpszarchivremt: PChar; dwopcines: DWORD; dwcntext: DWORD ): LngBl; hcnexión: un descriptr de cnexión btenid a través de InternetCnnect. lpszarchivlcal: un punter a una cadena en la que se pasa el nmbre del archiv lcal que se quiere enviar al servidr. Se puede incluir la ruta absluta relativa. lpszarchivremt: un punter a una cadena en la que se pasa el nmbre del archiv remt dnde querems almacenar la infrmación a enviar. Se puede incluir la ruta absluta relativa. dwcntext: el valr de cntext que querams pasar al llamar a la función de callback. La función retrna TRUE FALSE, dependiend de su éxit fracas. Cm dijims antes, pdems descargar enviar un archiv a través del métd direct (cn las funcines FtpGetFile y FtpPutFile) bien hacerl cm si de un archiv lcal se tratase, siguiend ls siguientes pass: 1. Apertura del archiv rigen y remt. En cas de una descarga, el archiv rigen será un archiv remt, y el archiv destin, será un lcal, cread vací. 2. Lectura del archiv rigen mientras queden dats y grabación de ls dats leíds en el archiv destin. 3. Cierre del ficher rigen y destin. Para la apertura de archivs lcales, pdems hacer us de la función CreateFile, tal y cm explicams durante nuestr artícul sbre Archivs pryectads en memria ( Si se trata de abrir un archiv un remt en un servidr FTP, tenems que hacer us de la función FtpOpenFile, que hems explicad en este mism artícul. Para la lectura y grabación en archivs lcales, tendrems que recurrir a las funcines ReadFile y WriteFile respectivamente, mientras que si se trata de leer escribir en un archiv remt, tenems las funcines InternetReadFile e InternetWriteFile, que ya explicams durante el artícul WinInet y HTTP ( Si estams leyend de un archiv remt, es recmendable también utilizar la función InternetQueryDataAvailable, tal y cm explicams en el artícul Más sbre WinInet y HTTP ( Este tr métd, aunque más cmplej y labris, es el recmendable a la hra de mstrar un indicadr de prgres en la descarga de un archiv ya que pdems averiguar el tamañ ttal del archiv (cn FtpGetFileSize) y cntrlams cmpletamente el prces de lectura byte a byte del archiv remt. Hay que tener cuidad cn este punt, ya que la apertura de archivs remt requiere de cnexines a través puerts especiales. Si nuestra cnexión a internet se hace a través de un crtafuegs un servidr prxy, es muy psible que estas cnexines se ds denieguen. Para slucinar este prblema debems realizar la cnexión siguiend el md pasiv, tal y cm explicams anterirmente. N vy a explicar las funcines, ya que prfundizams en ellas cuand hablams del prtcl HTTP (en ls artículs que he indicad antes). Pág. 17 de 20

18 Ejecutar cmands genérics Si dentr de tdas estas funcines n encuentras la que necesitas, n prblem, que tdavía hay más. Puedes utilizar la función FtpCmmand para ejecutar cualquier tip de cmand admitid pr el servidr FTP. Es sí, esta función sól está dispnible si tienes instalad Internet Explrer 5.0 superir. functin FtpCmmand( hcnexión: HINTERNET; fhayrespuesta: LngBl; dwopcines: LngWrd; lpszcmmand: PChar; dwcntext: LngWrd; var hrespuesta: HINTERNET ): LngBl; Nta: el módul WinInet.pas de Delphi cntiene un errr en la definición de esta función. La cabecera crrecta es la que aquí aparece, y si quieres utilizar FtpCmmand desde tus prgramas, debes imprtar la función de frma dinámica, bien del siguiente md: functin FtpCmmand( hcnexin: HINTERNET; fhayrespuesta: BOOL; dwopcines: DWORD; lpszcmmand: PChar; dwcntext: DWORD; var hrespuesta: HINTERNET): BOOL; stdcall; external 'wininet.dll' name 'FtpCmmandA'; hcnexión: un descriptr de cnexión btenid a través de InternetCnnect. fhayrespuesta: un valr blean que indica si el cmand retrna alg. En cas de pasarse el valr TRUE, se cpiará en phrespuesta el descriptr de la petición creada. dwopcines: FTP_TRANSFER_TYPE_ASCII: utiliza el tip de transferencia ASCII prpia de ls servidres FTP. Realiza las cnversines de la tabla ASCII crrespndiente. FTP_TRANSFER_TYPE_BINARY: utiliza el tip de transferencia binaria prpia de ls servidres FTP. El cntenid del archiv n se cambia. lpszcmand: una cadena cn el cmand a ejecutar. Puedes cnsultar una lista cn alguns de ls cmands en la tabla que puedes encntrar al principi del artícul. dwcntext: el valr de cntext que querams pasar al llamar a la función de callback. phrespuesta: se trata de un punter a un descriptr dnde se cpiará el descriptr btenid de crear la petición. Este descriptr se utiliza para leer la respuesta cn la función InternetReadFile. Hay que recrdar que este descriptr, cm cualquier tr, debe ser cerrad cn InternetClseHandle una vez que ya n l necesitems. La función retrna TRUE FALSE dependiend de su éxit. Cm sabems, un cmand FTP retrna un códig de respuesta, que pdems btener a través de InternetGetLastRespnseInf, y si además retrna un resultad (cm un archiv, un text, etc.) pdems leer del canal de dats a través de InternetReadFile, utilizand el descriptr btenid en phrespuesta. Para utilizar esta función es necesari cncer bien ls cmands FTP, saber cóm se llaman y qué retrnan, así que pdems decir que se trata de una función para avanzads. Pág. 18 de 20

19 De tdas frmas, cm intrducción y para que veáis cóm se utiliza, pdéis echar un vistaz al siguiente códig, dnde se hace un us muy sencill de FtpCmmand para btener el listad de archivs en un directri, a través del cmand NLST: var respuesta: HINTERNET; leid: DWORD; dispnible: DWORD; buffer: PChar; begin if FtpCmmand(<<descriptr de cnexión>>, true, FTP_TRANSFER_TYPE_ASCII, PChar('NLST'), 0, respuesta) then begin try InternetQueryDataAvailable(respuesta, dispnible, 0, 0); buffer := AllcMem(dispnible + 1); try InternetReadFile(respuesta, buffer, dispnible, leid); MessageBx(GetActiveWindw, buffer, 'Cmand NLST', MB_ICONINFORMATION); finally FreeMem(buffer); finally InternetClseHandle(respuesta); Una frma más fácil Después de explicar en prfundidad cóm utilizar el prtcl FTP, s vy a cnfesar un secret: existe un métd much más sencill de acceder a un recurs y descargarl. Recrdáis el métd direct para el prtcl HTTP? Y la función InternetOpenUrl? Pues en FTP también pdems hacer us de esta función. Simplemente pasand una URL que cmience pr ftp://, la función realizará td el trabaj suci y ns retrnará un descriptr al recurs que hems pasad pr parámetr. Una vez que tenems ese descriptr, pdems hacer us de él a través de la función InternetReadFile, y debems cerrarl cn InternetClseHandle una vez hayams terminad. N vy a entrar en más detalles prque ya explicams el us de esta función cuand hablams del prtcl HTTP. De tdas frmas, en el siguiente listad tenéis un ejempl muy sencill de us, para que veáis que en realidad n hay nada nuev que explicar: Pág. 19 de 20

20 var hurl: HINTERNET; dispnible: DWORD; leid: DWORD; buffer: PChar; begin hurl := InternetOpenUrl(<<descriptr btenid cn InternetOpen>>, 'ftp://ftp.brland.cm/pub/delphi/devsupprt/general/index.txt', nil, 0, 0, 0); if hurl <> nil then begin InternetQueryDataAvailable(hURL, dispnible, 0, 0); buffer := AllcMem(dispnible + 1); try InternetReadFile(hURL, buffer, dispnible, leid); MessageBx(GetActiveWindw, buffer, 'Cntenid', MB_ICONINFORMATION); finally FreeMem(buffer); Cnclusión Y est ya está terminand. Cm veis, el us del prtcl FTP y hems sid capaces de resumirl td en un sl artícul. Esper que haya quedad td l suficientemente clar, y que estas pequeñas indicacines s permitan empezar a desarrllar vuestrs clientes de FTP. En el siguiente artícul vams a prfundizar sbre el caché intern de WinInet (que es el mism que el de Internet Explrer) y las funcines que pdems utilizar para cnsultarl y mdificarl. Ls ejempls Delphi 5 Junt cn este artícul, pdéis estudiar el ejempl escrit en Delphi. Se trata de un cliente FTP semi-cmplet, que realiza cnexines a un servidr FTP, descarga y envía archivs, cnsulta las prpiedades de un archiv, etc. Pdéis ir viend ls distints métds de la clase TFtpCnnectin, en ls que se realizan las llamadas al API WinInet que hems id explicand durante el artícul. Además, y a md de repas, pdéis ver cóm hacer us de la función de callback utilizand el API WinInet. Fuentes en ZIP - Autr: JM - Pág. 20 de 20