For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:
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:
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 "firstname.lastname@example.org" 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.
- Call InternetOpenUrl. If the FTP server requires a name and password, include it in the URL.
- 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.
- Check for the HTTP status code. If status code indicates that proxy authentication is required, acquire user credentials.
- 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.
- Once credentials are acquired, the request must be resubmitted with the HttpSendRequest API.
- Before the request is resubmitted, all outstanding data must be read with the InternetReadFile function.
- When InternetReadFile is used to obtain a directory listing (for a URL such as ftp://server/MyDir), it may fail with error 122 "Insufficient buffer." In this case the forth parameter to the function, lpNumberOfBytesRead, will be set to 0 and will not indicate the size of the needed buffer. To determine the size of the minimal buffer to allocate, call the InternetQueryDataAvailable function.
How to Run the SampleThe 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
c:> readurlftp ftp://myserver/myfile.txt d:\temp\myfile.txt
c:> readurlftp ftp://User:Pass@myserver/MyDir con
c:> readurlftp ftp://myserver/MyDir con -u
ID d'article : 216214 - Dernière mise à jour : 22 juin 2014 - Révision : 1