Microsoft KB Archive/216214

= SAMPLE: FTP with CERN-Based Password Protected Proxy Using WinInet =

Article ID: 216214

Article Last Modified on 8/5/2004

-

APPLIES TO


 * Microsoft Internet Explorer 3.0
 * Microsoft Internet Explorer 4.0 128-Bit Edition
 * Microsoft Internet Explorer 5.0
 * Microsoft Internet Explorer 5.5
 * Microsoft Windows Internet Services (WinInet)

-



This article was previously published under Q216214



SUMMARY
ProxyFtp.exe is a sample that demontrates how to use the InternetOpenUrl WinInet API to send an FTP request through an HTTP type (that is, CERN) proxy that may require user authentication.



MORE INFORMATION
The following file is available for download from the Microsoft Download Center:

ProxyFtp.exe

For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:

119591 How to Obtain Microsoft Support Files from Online Services

Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file. WinInet uses the HTTP protocol to communicate with a proxy, but then the proxy connects to the FTP server via FTP protocol. This fact makes it impossible to use specific WinInet FTP APIs such as FtpOpenFile and FtpPutFile.

However, it is still possible to obtain a directory listing of the FTP server and download files using InternetOpenUrl. This protocol-independent API is capable of taking both an FTP URL, such as ftp://server, or an HTTP URL, such as http://server.

Under certain conditions, in addition to the FTP server requiring a set of credentials (that is, the user name and password), the proxy server may require a separate set of credentials. With InternetOpenUrl the user name and password required by the FTP server may be include in the URL, like this:

ftp://User:Pass@ftp.server.com/file.txt

Note This syntax is invalid for HTTP and does not allow a password to be included with the "@" sign.

If you do not specify the FTP user name and password in the URL, the proxy accesses the server with user "Anonymous" and some sort of generic password (for example, Microsoft Proxy uses "proxyuser@microsoft.com" as the password).

The technique below outlines steps that can be used to handle proxy authentication. In other words it explains how to submit a second set of credentials for the proxy itself.
 * 1) Call InternetOpenUrl. If the FTP server requires a name and password, include it in the URL.
 * 2) Check if the handle returned by InternetOpenUrl is of type HTTP. If the handle type is HTTP, it indicates that WinInet is communicating with HTTP type proxy.
 * 3) Check for the HTTP status code. If status code indicates that proxy authentication is required, acquire user credentials.
 * 4) The user name and password may be acquired and set with a standard user interface by calling InternetErrorDlg. If you do not want to use the standard user interface, you can just use InternetSetOption to set the user name and password.
 * 5) Once credentials are acquired, the request must be resubmitted with the HttpSendRequest API.

How to Run the Sample
The sample uses the INTERNET_OPEN_TYPE_PRECONFIG Internet access type. Therefore, if Internet Explorer is configured to use an HTTP proxy, the sample will use the same proxy.

Use the following to get Myfile.txt and dump it to the console by using an anonymous FTP connection: c:> readurlftp ftp://myserver/myfile.txt con To peform the same as operation as above, but to save the file locally: c:> readurlftp ftp://myserver/myfile.txt d:\temp\myfile.txt Use the following to get a directory listing from MyDir and dump the results to the console while using a specific user name and password required by the FTP server: c:> readurlftp ftp://User:Pass@myserver/MyDir con Perform the same task as above, except use the following to use the standard user interface (for example, bring up the standard dialog box) to enter proxy credentials in addition to FTP server credentials: c:> readurlftp ftp://myserver/MyDir con -u

