Win32::Internet Introduction

# Win32::Internet

Internet extension for Win32 PERL
Version 0.08 (14 Feb 1997)
by Aldo Calpini (dada@divinf.it)

## Introduction

This extension to Perl implements the Win32 Internet APIs (found in WININET.DLL). They give a complete support for HTTP, FTP and GOPHER connections.

See the Version History and the Functions Table for a list of the currently supported features. You should also get a copy of the Microsoft Win32 Internet Functions documentation.

## Disclaimer

This program is FREE; you can redistribute, modify, disassemble, or even reverse engineer this software at your will. Keep in mind, however, that NOTHING IS GUARANTEED to work and everything you do is AT YOUR OWN RISK - I will not take responsability for any damage, loss of money and/or health that may arise from the use of this program!

This is distributed under the terms of Larry Wall's Artistic License.

## Credits

Win32::Internet is based on the Win32::Registry code written by Jesse Dougherty.
Additional thanks to: Carl Tichler for his help in the initial development; Tore Haraldsen, Brian Helterline for the bugfixes; Dave Roth for his great source code examples.

## Version History

0.08 (14 Feb 1997)

- fixed 2 more bugs in Option(s) related subs (thanks to Brian Helterline!).
- Error() now gets error messages directly from WININET.DLL.
- The PLL file now comes in 2 versions, one for Perl version 5.001 (build 100) and one for Perl version 5.003 (build 300 and higher). Everybody should be happy now :)
- added an installation program.

0.07 (10 Feb 1997)

- fixed a bug in Version() introduced with 0.06...
- completely reworked PM file, fixed *lots* of minor bugs, and removed almost all the warnings with "perl -w".

0.06 (26 Jan 1997)

- fixed another hideous bug in "new" (the 'class' parameter was still missing).
- added support for asynchronous operations (work still in embryo).
- removed the ending \0 (ASCII zero) from the DLL version returned by "Version".
- added a lot of constants.
- added safefree() after every safemalloc() in C... wonder why I didn't it before :)
- added TimeConvert, which actually works one way only.

0.05f (29 Nov 1996)

- fixed a bug in "new" (parameters passed were simply ignored).
- fixed another bug: "Chdir" and "Cwd" were aliases of RMDIR instead of CD..

0.05 (29 Nov 1996)

- added "CrackURL" and "CreateURL".
- corrected an error in TEST.PL (there was a GetUserAgent instead of UserAgent).

0.04 (25 Nov 1996)

- added "Version" to retrieve package and DLL versions.
- added proxies and other options to "new".
- changed "OpenRequest" and "Request" to read parameters from a hash.
- added "SetOption/QueryOption" and a lot of relative functions (connect, username, password, useragent, etc.).
- added "CanonicalizeURL" and "CombineURL".
- "Error" covers a wider spectrum of errors.

0.02 (18 Nov 1996)

- added support for HTTP sessions and requests.

0.01 (11 Nov 1996)

- fetching of HTTP, FTP and GOPHER URLs.
- complete set of commands to manage an FTP session.

## Installation Instructions

1. Make sure you have somewhere in your Windows directory the file WININET.DLL: it comes with Microsoft Internet Explorer 3.0, or it can be downloaded from http://www.divinf.it/dada/perl/internet/wininet.zip.

2. Run the INSTALL.BAT program.

3. Run the TEST.PL script to see if everything works.

4. Have fun.

10 Feb 1997, Aldo Calpini <dada@divinf.it>