The era of stand-alone, self-contained applications is rapidly ending. Distributed, networked applications have become critical to meeting business needs in a fast-paced, dynamic world. Until now, building networked Windows applications wasn't easy. But now Microsoft has released a powerful new Windows Internet API (WinInet) that dramatically simplifies the process of creating Internet-enabled Windows applications.
WinInet makes it possible to create Windows applications that can download Web pages, access server applications, upload and download files, and traverse Gopher document systems--allowing developers to build such sophisticated Windows Internet applications as full-fledged Web browsers, home banking applications, and stock portfolio programs.
Essential WinInet is a comprehensive guide to this powerful Windows Internet API. It starts with a tutorial on WinInet basics and a methodical description of the API's protocol-specific functions for HTTP, FTP, and Gopher, then proceeds to explore more advanced topics, examining how WinInet works with other Internet tools and client/server technologies. This book addresses such essential topics as:
Numerous sample applications throughout this book explore WinInet's capabilities and show you how to put the API to work. The samples include a full-featured asynchronous FTP client for Windows; a stock portfolio application that can connect to real-time Internet stock quote providers; and a client/server application that incorporates WinInet, ISAPI, and ASP. Much more than just a tutorial, this practical resource contains the kinds of pointers, work-arounds, and creative solutions that will save you hours of frustration and inspire you to make full use of the API.
I. WININET BASICS.1. WinInet Basics.
Is This Book for You?
Book Overview by Chapter.
Developing Internet Applications.
What Can You Do with WinInet?
HTTP, FTP, and Gopher.
Programming with WinInet.
Documentation and Samples.
Microsoft Internet Client SDK.
Advantages of WinInet over Winsock.
Easy to Use.
Advantages of Winsock over WinInet.
Your First WinInet Program.2. WinInet General Functions.
WinInet General Functions.
The Next Step.
General Internet Function Summary.
Internet File Functions.
Reading Files without the Content-Length Header.
Locking File Resources.
Internet Option Functions.
Internet Time Functions.
Other Internet Helper Functions.
InternetGetLastResponseInfo.3. Handling URLs.
Using SSL with InternetOpenUrl.
InternetOpenUrl Sample Program (InetURL).
II. WININET PROTOCOL-SPECIFIC FUNCTIONS.4. HTTP Functions.
The HTTP Protocol.
The HTTP Model.
The HTTP Request.
The HTTP Response.
Using Telnet to Test HTTP.
A Complete HTTP Transaction.
HTTP Protocol Summary.
WinInet HTTP Functions.
HTTP Functions Overview.
HTTP Authentication Techniques.
Using SSL with HTTP.
Web Page Retrieval Example.5. FTP Functions.
The FTP Protocol.
The FTP Model.
A Typical FTP Scenario.
Using Telnet to Test FTP.
FTP Protocol Summary.
WinInet FTP Functions.
FTP Functions Overview.
Sample FTP Client.
FTP Function Descriptions.6. Gopher Functions.
The Gopher Protocol.
The Gopher Model.
Gopher Response Items.
Gopher Selector String.
Using Telnet to Test Gopher.
Gopher Protocol Summary.
WinInet Gopher Functions.
Gopher Functions Overview.
Sample Gopher Application.
III. MFC AND VISUAL BASIC.7. WinInet MFC Internet Classes.
WinInet MFC Classes.
Getting Started with MFC WinInet Support.
Global MFC Internet Functions.8. WinInet in Visual Basic.
Microsoft Internet Transfer Control.
Sample Application Using OpenURL.
Using WinInet Directly.
Revamped Sample Application Using InternetOpenUrl.
IV. ADVANCED WININET.9. Asynchronous WinInet.
Synchronous versus Asynchronous.
Pros and Cons.
WinInet's Built-in Asynchronous Support.
MyFTP: Asynchronous FTP Sample Application.
Establishing the Asynchronous Internet Session.
The Rest of the Details.10. Reusable WinInet COM Components.
Stock Watcher Sample Application.
The QuoteProvider Component.
The CProviderYahoo Component.
Adding Interface Methods.
Didn't We Mean IQuoteProvider?
Creating Additional IQuoteProvider Components.
The QuoteProvider Component Category.
The HTTP Component.
WinInet and Threads--A Quick Thread Tutorial.
The Stock Watcher Application.
Refresh All.11. Establishing a Dial-up Connection.
WinInet Dial-up Functions.
InternetAutodial and InternetAutodialHangup.
InternetDial and InternetHangUp.
To Use or Not to Use . . . That Is the Question!.
Remote Access Service.
Using the RAS Common Dialogs.
Begin and End a RAS Connection with RasDial and RasHangUp.
Working with Phonebook Entries.
Windows NT 4.0 RAS AutoDial.
RAS Connection Information.
V. INTERNET CLIENT/SERVER APPLICATIONS.12. Internet Client/Server Applications with WinInet, ISAPI, and ASP.
Internet Client/Server Development Decisions.
BugTracker: A Client/Server Bug-Tracking System.
Sample ISAPI Extension DLL.
Active Server Pages.
Generating an HTML View.
Sample WinInet Client.
Appendix A. TCP/IP Tutorial.
TCP/IP Protocol Layering.
The Physical Layer.
Appendix B. API Flags.
Appendix C. Internet Option Flags.
Appendix D. Error Messages.
Appendix E. Recommended Reading.
COM and ATL.
ISAPI and ASP.
A few years ago I found out that I would be responsible for making our Windows product capable of connecting to a client's backend system and downloading data via the Hypertext Transfer Protocol (HTTP). As is common these days, I had a very short time frame. At the time, all I knew about HTTP was that somehow it made the Internet work. After becoming familiar with the protocol, I started researching the development tools available for the task at hand.
Because our application required advanced features like the secure sockets layer (SSL), proxies, dial-up connections, and caching, right away I knew that Winsock was out of the question. Although Winsock is what most developers use in projects like this, it requires the developer to implement all of the desired protocol functionality. The time frame dictated that this was not viable.
I continued my search for the latest and greatest HTTP component. I wanted something that not only took care of the advanced protocol features, but would also allow me to work with the protocol through a high-level interface. Although I found a few ActiveX controls that claimed to do this, I found all of them lacking in major functional areas.
Just when I thought all hope was lost, I discovered Microsoft's new Windows Internet API, also known as WinInet. After immersing myself in WinInet, I was pleased to find that it provided just the layer of abstraction that I needed. I learned that WinInet elegantly simplifies all of the advanced HTTP features mentioned earlier. In short, it was the perfect development tool for the project.
As it turned out, choosing WinInet allowed us to complete the project successfully on schedule with all of the required HTTP functionality incorporated. Although I make it sound like a bed of roses, there were plenty of obstacles along the way. The biggest obstacle was the lack of WinInet documentation. Because WinInet is such a new and unheard of technology, not much WinInet documentation exists.
As a result of this lack of documentation, I struggled through the WinInet learning curve and other problematic issues that cost me many late nights. After completing the project, I decided that I could help other developers avoid the same problems that I encountered. Hence, I set out to write a few articles for Microsoft Interactive Developer and Microsoft Systems Journal on the topic. Publishing the articles was like giving a few drops of water to a parched soul. The e-mail started pouring in with follow-up questions on various WinInet topics.
Even today, the WinInet documentation only includes the online documentation, a few technical articles, and a single chapter in a couple of Visual C++/Microsoft Foundation Classes (MFC) books. After experiencing the demand and witnessing the shortage, I realized the need for a single, authoritative source for WinInet information--Essential WinInet.
At the time of this writing, Essential WinInet is the only book on the market dedicated entirely to the Windows Internet API. Other books may cover WinInet briefly, but none of them helped me in my time of need. The purpose of this book is to help both the WinInet beginner as well as the WinInet warrior who is already battling on the front line. This book is more than an API tutorial because it's based on real-world experience. Throughout the book you'll find valuable information and basic tips that I wish someone would have told me when I first started. Hopefully, this book will not only save you time and money, but will also reduce grief and headaches.Organization
This book is divided into five parts: WinInet Basics, WinInet Protocol-Specific Functions, MFC and Visual Basic, Advanced WinInet, and Internet Client/Server Applications. If you're a WinInet beginner, you'll benefit tremendously from Parts I and II. By the time you finish the first two parts, you'll have a complete understanding of WinInet and will be able to write WinInet programs using any of the WinInet-supported protocols.
If you're an MFC or Visual Basic programmer, you'll want to pay special attention to Part III. The two chapters that make up Part III focus on using WinInet with each of these popular development tools. The chapter on MFC not only shows you how to use the WinInet MFC classes, but also provides valuable insight into how the classes interact with the API behind the scenes.
Part IV covers advanced WinInet topics, including asynchronous WinInet, writing HTTP Component Object Model (COM) components, and establishing dial-up connections (also covering the Remote Access Service API). Each chapter in this section offers a practical sample application worth more than a thousand pages of explanation. For example, Chapter 9 walks through the process of creating a full-featured, asynchronous File Transfer Protocol client for Windows. Also, Chapter 10 demonstrates how to develop my all-time favorite sample program, Stock Watcher. Stock Watcher is a personal stock portfolio application that is capable of connecting to various stock quote providers on the Internet (Yahoo!, Quote.com, and Datek) and downloading real-time stock quotes.
The final part of this book, Part V, introduces the concept of Internet client/server programming. It briefly covers the most widely used server-side technologies including Common Gateway Interface (CGI), Internet Server API (ISAPI), and Active Server Pages (ASP); then it walks you through a sample program that demonstrates how to implement a complete client/server solution using these technologies.
Appendix A contains a Transmission Control Protocol/Internet Protocol (TCP/IP) tutorial for those of you craving to know more about how the Internet works under the hood. This section covers both the TCP and IP protocols, and offers some informative diagrams to help you see through the fog. Appendixes B, C, and D contain descriptions of the most common WinInet API flags, option flags, and error messages. Finally, Appendix E contains a list of recommended supplemental reading on most of the technologies mentioned throughout the book including WinInet, Internet protocols, COM, Active Template Library (ATL), multithreading, Internet Server API (ISAPI), and Active Server Pages (ASP). If this book leaves you wanting more in one of those areas, be sure to check out my recommendations.Tips
The tips included throughout this book are very helpful. Some are related to a problem that I encountered that cost me extra time to figure out. Other tips contain pieces of information not found anywhere in the online documentation. You can be sure that all tips found in this book are definitely tip worthy and should not be overlooked. Tips appear in a shaded box and are called out with an icon.Web Site
If you're still wondering where the accompanying CD is, you can stop looking-- there isn't one. Because this book is about Windows Internet development, I thought it would be more than appropriate to replace the standard accompanying CD with the Essential WinInet Web site. All sample programs found throughout the book can be downloaded from the Essential WinInet Web site. As bugs surface (as I'm sure they will), I'll post regular updates to the sample code. The Essential WinInet Web site may also serve as the central location for WinInet information. It not only contains links to other WinInet sites on the Web, but also contains an up-to-date list of recommended reading.