196 lines
8.5 KiB
HTML
196 lines
8.5 KiB
HTML
<head>
|
||
<title>IIS Samples - ISAPI KeepAlive With Threads</title>
|
||
</head>
|
||
<body>
|
||
|
||
<a name="top"></a>
|
||
<p>
|
||
<h2>IIS Samples - ISAPI KeepAlive With Threads</h2>
|
||
<a name="IIS_KeepAliveP"></a>
|
||
|
||
<p>
|
||
This sample demonstrates how to maintain a Keep-Alive connection while using worker threads in an ISAPI dll.
|
||
</p>
|
||
|
||
<p><font color="blue"><b>Important</b></font> These samples are provided for educational purposes only. They are not
|
||
intended to be used in a production environment, have not been tested in a production
|
||
environment, and Microsoft does not provide technical support for them.
|
||
|
||
<p>
|
||
</p>
|
||
<p>
|
||
<a href="#ovr">Sample Overview</a><br>
|
||
<a href="#req">Requirements</a><br>
|
||
<a href="#loc">Location of the Source Code</a><br>
|
||
<a href="#bld">Build and Install the Sample</a><br>
|
||
<a href="#run">Run the Sample</a><br>
|
||
<a href="#out">Sample Output</a><br>
|
||
<a href="#hlp">Helpdesk</a></p>
|
||
<p>
|
||
</p>
|
||
<h4><a name="ovr"></a>Sample Overview</h4>
|
||
<p>
|
||
The way that this dll maintains the connection is in the following line from WorkerFunction:
|
||
</p>
|
||
<p>
|
||
<code>dwState = HSE_STATUS_SUCCESS_AND_KEEP_CONN;<br>
|
||
pECB->ServerSupportFunction(pECB->ConnID, HSE_REQ_DONE_WITH_SESSION, &dwState, NULL, 0);</code>
|
||
</p>
|
||
<p>
|
||
The passing of dwState is what tells IIS to keep the connection open.
|
||
</p>
|
||
<p>
|
||
A thread pool is used because if the thread that makes the above call to server support function exits or is terminated, the connection will be closed by IIS. Using a thread pool avoids this.
|
||
</p>
|
||
<p>
|
||
This dll creates a number of system objects, which are not deallocated. The presumption is that this dll will remain loaded until the INETINFO.EXE process terminates; at which point these objects will be released by the operating system. However, if the WWW service is stopped and restarted without the INETINFO.EXE process ending, these objects will remain allocated, and new ones will be created when the dll is reloaded. If it is desired to implement this sample code in a production environment, code to deallocate these objects should be added in DllMain or TerminateExtension.
|
||
</p>
|
||
<font size="2"><a href="#top">to top</a></font>
|
||
<p> </p>
|
||
<h4><a name="req"></a>Requirements</h4>
|
||
<p>This sample requires the installation of the following software to
|
||
function properly:</p>
|
||
<ul>
|
||
<li>Windows XP Professional with IIS 5.1 installed or Windows XP Server with
|
||
IIS 6.0 installed.</li>
|
||
</ul>
|
||
<font size="2"><a href="#top">to top</a></font>
|
||
<p> </p>
|
||
<h4><a name="loc"></a>Location of the Source Code</h4>
|
||
<p>IIS samples are included in the IIS Software Developer Kit (SDK).
|
||
You can download the IIS SDK from
|
||
<a href="http://go.microsoft.com/fwlink/?LinkId=7298">Platform SDK Update</a>.
|
||
You can view the SDK at <a href="http://go.microsoft.com/fwlink/?LinkId=1694">MSDN Online</a>.
|
||
In the table of contents at MSDN Online, click <b>Web Development</b>, <b>Server Technologies</b>,
|
||
<b>Internet Information Services (IIS)</b>, <b>SDK Documentation</b>,
|
||
<b>Internet Information Services</b>, <b>Samples</b>.</p>
|
||
<p>The following source code files are required for this sample:</p>
|
||
<table border="1">
|
||
<tr>
|
||
<th>File</th>
|
||
<th>Description</th>
|
||
</tr>
|
||
<tr>
|
||
<td>KeepAliveP.sln</td>
|
||
<td>KeepAliveP Visual Studio .NET solution file, required to build this sample in Visual Studio .NET.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>KeepAliveP.vcproj</td>
|
||
<td>KeepAliveP Visual Studio .NET C Project file, required to build this sample in Visual Studio .NET.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>KeepAliveP.dsp, KeepAliveP.dsw</td>
|
||
<td>KeepAliveP Visual Studio 6.0 project files, required to build this sample in Visual Studio Version 6.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>KeepAliveP.c, ThreadPool.c</td>
|
||
<td>KeepAliveP source modules containing the code that implements the sample.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>KeepAliveP.def</td>
|
||
<td>KeepAliveP.dll definition containing code for creating the sample.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>ThreadPool.h</td>
|
||
<td>KeepAliveP header file containing commonly called routines.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>MAKEFILE</td>
|
||
<td>KeepAliveP makefile for command line compilation</td>
|
||
</tr>
|
||
</table><br>
|
||
<font size="2"><a href="#top">to top</a></font>
|
||
<p> </p>
|
||
<h4><a name="bld"></a>Build and Install the Sample</h4>
|
||
<p>To build this sample using the Visual C++ IDE, the following
|
||
steps must be performed:</p>
|
||
<ol>
|
||
<li>Open the solution (VS.NET) or desktop (VS6) file to open the project.</li>
|
||
<li>Click <b>Build</b> to create the DLL.</li>
|
||
</ol>
|
||
<p>To build and run this sample without using the Visual C++ IDE, the
|
||
following steps must be performed:</p>
|
||
<ol>
|
||
<li>Type <b>NMAKE All</b> from the command line. For example, if your sample files are located in
|
||
a folder called <code>C:\MySamples</code>, type the following at the command line:
|
||
<pre>cd /d c:\MySamples
|
||
NMAKE All</pre>
|
||
</li>
|
||
</ol>
|
||
<p> </p>
|
||
<p>To install this sample, the following steps must be performed:</p>
|
||
<ol>
|
||
<li>Copy KeepAliveP.dll to a physical folder on your computer. For example,
|
||
create a folder called <code>C:\Samples</code> and copy KeepALiveP.dll to that folder.</li>
|
||
<li>Create a virtual directory that maps to the physical folder containing your files. To create
|
||
a virtual directory, open the Internet Information Services (IIS) Manager by clicking <b>Start</b>,
|
||
<b>Run</b>, type <code>inetmgr</code> in the text box and click <b>OK</b>. Right-click on the Web
|
||
site where you want to create a virtual directory, click <b>New</b>, and click <b>Virtual
|
||
Directory</b>. In the <b>Alias</b> text box, type the name you want for your virtual directory, for
|
||
example, <code>KeepAliveP</code>. In the <b>Directory</b> text box, type the path to the
|
||
folder that contains your files.
|
||
<li>Configure strong security on your new virtual directory. Right-click the virtual directory name,
|
||
click <b>Properties</b>, and click the <b>Directory Security</b> tab. Press F1 for tips on
|
||
securing your virtual directory.</li>
|
||
<li>Use Windows Explorer to set restricted access control on the sample .dll file in its physical folder.
|
||
For more information, click <b>Start</b>, <b>Help and Support</b>, and search for <b>Access Control</b>.</li>
|
||
</ol>
|
||
<font size="2"><a href="#top">to top</a></font>
|
||
<p> </p>
|
||
<h4><a name="run"></a>Run the Sample</h4>
|
||
<p>In order to run this sample, follow the instructions listed below:</p>
|
||
<ol>
|
||
<li>Browse to your sample Web files in Internet Explorer (IE). For example, if your files are in a
|
||
virtual directory called <code>KeepAliveP</code>, type
|
||
<code>http://localhost/KeepAliveP/KeepAliveP.dll</code> in the <b>Address</b> bar
|
||
of IE.
|
||
</li>
|
||
</ol>
|
||
<font size="2"><a href="#top">to top</a></font>
|
||
<p> </p>
|
||
<h4><a name="out"></a>Sample Output</h4>
|
||
<p>
|
||
There is no output for this sample.
|
||
</p>
|
||
<font size="2"><a href="#top">to top</a></font>
|
||
<p> </p>
|
||
<h4><a name="hlp"></a>Help Desk</h4>
|
||
<p>If here you do not find answers to your questions, visit the
|
||
<a href="http://go.microsoft.com/fwlink/?linkid=1782">Microsoft Help and Support</a>
|
||
Web site.</p>
|
||
<table border="1">
|
||
<tr>
|
||
<th>Problem</th>
|
||
<th>Possible Solution</th>
|
||
</tr>
|
||
<tr>
|
||
<td>When browsing to the ASP page, IE returns <b>HTTP 404 - File not found</b></td>
|
||
<td>Verify that you have created a virtual directory of the same name you
|
||
are typing in the Address box of IE....</td>
|
||
</tr>
|
||
<tr>
|
||
<td>When building the dll, C++ or VB returns the a permissions error.</td>
|
||
<td>Once you have called the dll from your web page, your system considers
|
||
it a loaded dll. You must unload it to build it again, either by
|
||
unloading the ASP application or deleting the dll from system32\dllcache.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>When building the dll, C++ returns a permissions error.</td>
|
||
<td>Once you have called the dll from your web page, your system considers
|
||
it a loaded dll. You must unload it to build it again, either by
|
||
unloading the ASP application or deleting the dll from system32\dllcache.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>When browsing to the dll, IE gives you a permissions error.</td>
|
||
<td>The folder and virtual directory must have Execute permissions set on them.</td>
|
||
</tr>
|
||
</table><br>
|
||
<font size="2"><a href="#top">to top</a></font>
|
||
|
||
<hr class="iis" size="1">
|
||
<p align="center"><i><EFBFBD> 1997-2002 Microsoft Corporation. All rights reserved.</i></p>
|
||
|
||
</body>
|
||
</html>
|
||
|