Los rincones del API Win32: WinInet y FTP - Ejecutar comandos genéricos

Si dentro de todas estas funciones no encuentras la que necesitas, “no problemo”, que todavía hay más. Puedes utilizar la función FtpCommand para ejecutar cualquier tipo de comando admitido por el servidor FTP. Eso sí, esta función sólo está disponible si tienes instalado Internet Explorer 5.0 o superior. BOOL FtpCommand( HINTERNET hConexión, BOOL fHayRespuesta, DWORD dwOpciones, LPCTSTR lpszComando, DWORD dwContexto, HINTERNET* phRespuesta );

• hConexión: un descriptor de conexión obtenido a través de InternetConnect.
• fHayRespuesta: un valor booleano que indica si el comando retorna algo. En caso de pasarse el valor TRUE, se copiará en phRespuesta el descriptor de la petición creada.
• dwOpciones:
  • FTP_TRANSFER_TYPE_ASCII: utiliza el tipo de transferencia ASCII propia de los servidores FTP. Realiza las conversiones de la tabla ASCII correspondiente.
  • FTP_TRANSFER_TYPE_BINARY: utiliza el tipo de transferencia binaria propia de los servidores FTP. El contenido del archivo no se cambia.
• lpszComando: una cadena con el comando a ejecutar. Puedes consultar una lista con algunos de los comandos en la tabla que puedes encontrar al principio del artículo.
• dwContexto: el valor de contexto que queramos pasar al llamar a la función de callback.
• phRespuesta: se trata de un puntero a un descriptor donde se copiará el descriptor obtenido de crear la petición. Este descriptor se utiliza para leer la respuesta con la función InternetReadFile. Hay que recordar que este descriptor, como cualquier otro, debe ser cerrado con InternetCloseHandle una vez que ya no lo necesitemos.

La función retorna TRUE o FALSE dependiendo de su éxito. Como sabemos, un comando FTP retorna un código de respuesta, que podemos obtener a través de InternetGetLastResponseInfo, y si además retorna un resultado (como un archivo, un texto, etc.) podemos leer del canal de datos a través de InternetReadFile, utilizando el descriptor obtenido en phRespuesta.

Para utilizar esta función es necesario conocer bien los comandos FTP, saber cómo se llaman y qué retornan, así que podemos decir que se trata de una función para avanzados.

De todas formas, como introducción y para que veáis cómo se utiliza, podéis echar un vistazo al siguiente código, donde se hace un uso muy sencillo de FtpCommand para obtener el listado de archivos en un directorio, a través del comando NLST:

{ HINTERNET respuesta; DWORD leido; DWORD disponible; char *buffer; if ( FtpCommand(<<descriptor de conexión>>, TRUE, FTP_TRANSFER_TYPE_ASCII, "NLST", 0, &respuesta) ) { try { InternetQueryDataAvailable(respuesta, &disponible, , ); buffer = new char[disponible + 1]; try { InternetReadFile(hURL, buffer, disponible, &leido); MessageBox(GetActiveWindow(), buffer, "Comando NLST", MB_ICONINFORMATION); } finally { delete buffer; } } finally { InternetCloseHandle(respuesta); } } }