README.TXT

FWASYNC.dll - File Transfer using Asynchronous WriteClient() inside ISAPI DLL 

Overview
--------
FWASYNC.DLL is a sample ISAPI Extension DLL to demonstrate Asynchronous
WriteClient functionality in the ISAPI interface. This dll illustrates
how one can use the WriteClient() callback in the ECB to perform an
Asynchronous IO operation.

FWASYNC.dll sends the file specified on the query string. It also converts
a virtual file-path (given in the URL name-space) into a physical file
name using the ServerSupportFunction( HSE_REQ_MAP_URL_TO_PATH) function.
The ISAPI DLL setsup the callback context and function using the
ServerSupportFunction( HSE_REQ_IO_COMPLETION) in the ECB.

Installation:
-------------
Build FWASYNC.dll and copy the .dll into the virtual directory maked with
"execute" permissions.

To run:
-------

Reference FWASYNC.DLL file as a URL from the browser,
specifying a file-name on the query string.

For example, the following URL entered on the address line of your browser
will transfer file SAMPLE.GIF, located in WWW root directory:

http://localhost/scripts/fwasync.dll?/sample.gif

Disclaimer:
-----------
This sample is provided for the purpose of demonstrating an ISAPI
extension. It has not been tested for use in a production environment
and no support will be provided for use in a production environment.