На этом шаге мы рассмотрим алгоритм добавлниея функции в расширение сервера.

Сейчас мы добавим в ISAPI-расширение сервера простую функцию по имени GetColor(). В качестве параметра она принимает один из цветов HTML и создает страницу с фоном этого цвета.

Добавление функции GetColor().
1. Добавьте следующие строки в карту анализа файла МyExtension.cpp.
```
    ON_PARSE_COMMAND(GetColor, CMyExtensionExtension, ITS_PSTR) 
    ON_PARSE_COMMAND_PARAMS("color")
```
  Рис.1. Добавление макросов
  Макрос ON_PARSE_COMMAND определяет имя класса, соответствующее имени функции. Передаваемые в нее параметры указываются начиная с третьего параметра макроса ON_PARSE_COMMAND. Типы параметров задаются макросом ON_PARSE_COMMAND_PARAMS. В строках примера подразумевается, что GetColor() принимает один параметр color.
2. В ClassView командой Add Member Function добавьте в класс CMyExtensionExtension следующую функцию-член:
```
  void GetColor(CHttpServerContext *pCtxt, LPCTSTR pstrColor)
```
3. Реализуйте эту функцию таким образом:
```
void CMyExtensionExtension::GetColor(CHttpServerContext *pCtxt, LPCTSTR pstrColor)
{
  StartContent(pCtxt);
  WriteTitle(pCtxt);
  *pCtxt << _T("You have chosen the ");
  *pCtxt << pstrColor << _T(" page.\r\n");
  *pCtxt << _T("<SCRIPT language=\"JavaScript\"> document.bgColor = \"");
  *pCtxt << pstrColor << _T("\" </SCRIPT>\r\n");
  EndContent(pCtxt); 
}
```
4. Соберите и запустите проект MyExtension. В папке \INetPub\WWWRoot\MyISExtensions замените старую версию DLL на новую. Но перед этим Вам придется остановить Web-сервер на Вашем компьютере, так как DLL-библиотеки ISAPI-расширения сервера загружаются в процесс IIS при первом их вызове и остаются там до завершения работы службы WWW. В случае с IIS это проще всего сделать, введя в командной строке следующую команду:
```
   net stop w3svс
```
5. Заменив DLL, перезапустите службу командой
```
    net start w3svc
```
  Новая версия DLL будет загружена при первом клиентском вызове.
  Следующий HTML-документ позволит проверить добавленную функцию расширения. Он состоит из простой формы, дающей пользователю возможность выбирать цвет из раскрывающегося списка. Кнопка Подача запроса служит для загрузки с сервера страницы выбранного цвета.
```
<!-- Form.htm ->
<HTML>
<HEAD>
<TITLE>Форма выбора цвета</TITLE> 
</HEAD> 
<BODY>
<H3> Выберите цвет из списка и нажмите кнопку SUBMIT</H3>
<FORM action="myextension.dll?GetColor" method=POST> 
<SELECT name="color">
  <option> pink
  <option> green
  <option> yellow
  <option> blue 
</SELECT> 
<P>
  <input type="submit"> 
</FORM> 
</BODY> 
</HTML>
```
  Поместите файл Form.htm в папку \INetPub\WWWRoot\MуISExtensions.
6. Запустите Internet Explorer и введите в адресную строку следующий URL:
```
  http://имя_компьютера/apps/Form.htm
```
  Страница будет выглядеть, как показано на рисунке 2.
  
  Рис.2. Страница Form.htm, открытая в Internet Explorer
7. Выберите цвет из списка и щелкните по кнопке. В браузере откроется страница с выбранным цветом фона.
  
  Рис.3. Страница с выбранным цветом фона

Созданную DLL и форму можно взять здесь (12,7 Кб).

На следующем шаге мы приведем общие сведения об ISAPI-фильтрах.

Предыдущий шаг Содержание Следующий шаг