Поделиться через

Пошаговое руководство. Создание модуля HTTP Global-Level с помощью машинного кода

  • Статья

В этом пошаговом руководстве показано, как использовать C++ для создания примера модуля HTTP глобального уровня, реализующего новую архитектуру обработки запросов в IIS 7. Эта новая архитектура расширяет возможности программирования машинного кода при написании приложений IIS более ранних версий ASP.NET модулей HTTP и фильтров или расширений ISAPI. Дополнительные сведения о проектировании модулей HTTP с использованием новой архитектуры обработки запросов см. в разделе Проектирование модулей Native-Code HTTP.

В этом пошаговом руководстве вы создадите проект C++ для модуля HTTP, добавите необходимый код для проекта "Hello World", а затем скомпилируете и протестируете модуль.

Предварительные требования

Для выполнения действий, описанных в примере, требуется следующее программное обеспечение:

  • IIS 7.

  • Visual Studio 2005.

Примечание

Вы также можете использовать Visual Studio .NET 2003 или более ранней версии, хотя пошаговые инструкции могут быть не идентичными.

Создание модуля

В этой части пошагового руководства вы создадите пустой проект библиотеки DLL C++ для модуля HTTP.

Создание проекта библиотеки DLL C++

  1. Запустите Visual Studio 2005.

  2. Убедитесь, что глобальные параметры имеют все правильные пути к файлам пакета SDK:

    1. В меню Сервис выберите пункт Параметры.

    2. Разверните узел Проекты и решения в представлении в виде дерева, а затем щелкните Каталоги VC++.

    3. В раскрывающемся списке Показать каталоги для выберите Включить файлы.

    4. Убедитесь, что указан путь, по которому вы установили включаемые файлы пакета SDK. Если путь отсутствует в списке, щелкните значок Создать строку , а затем добавьте путь к установленным файлам включения пакета SDK.

    5. Нажмите кнопку ОК.

  3. Создайте проект C++:

    1. В меню Файл укажите Создать, затем нажмите Проект.

      Откроется диалоговое окно Новый проект .

    2. В области Типы проектов разверните узел Visual C++ и щелкните Win32.

    3. В области Шаблоны выберите Проект Win32.

    4. В поле Имя введите HelloWorld.

    5. В поле Расположение введите путь к примеру.

    6. Нажмите кнопку ОК.

      Откроется мастер приложений Win32 .

    7. Щелкните Параметры приложения.

    8. В разделе Тип приложения щелкните DLL.

    9. В разделе Дополнительные параметры щелкните Пустой проект.

    10. Нажмите кнопку Готово.

Добавление файлов кода и исходных файлов

Следующим шагом является добавление необходимых файлов C++ и module definition-files в проект.

Добавление исходных файлов в проект

  1. Создайте файл определения модуля для экспорта функции RegisterModule :

    1. В Обозреватель решений щелкните правой кнопкой мыши исходные файлы, наведите указатель мыши на пункт Добавить, а затем выберите пункт Создать элемент.

      Откроется диалоговое окно Добавление нового элемента.

    2. Разверните узел Visual C++ в области Категории и щелкните Код.

    3. В области Шаблоны выберите шаблон Файл определения модуля .

    4. В поле Имя введите HelloWorld и оставьте путь к файлу по умолчанию в поле Расположение .

    5. Нажмите кнопку Добавить.

    6. Добавьте следующий код:

      LIBRARY HelloWorld  

EXPORTS  
    RegisterModule

  2. При необходимости можно экспортировать функцию RegisterModule с помощью параметра /EXPORT:RegisterModule :

    1. В меню Проект выберите свойства HelloWorld.

    2. Разверните узел Свойства конфигурации в представлении дерева, разверните узел Компоновщик и щелкните Командная строка.

    3. В раскрывающемся списке Конфигурация выберите Все конфигурации.

    4. В поле Дополнительные параметры введите /EXPORT:RegisterModule.

    5. Нажмите кнопку ОК.

  3. Создайте файл C++:

    1. В Обозреватель решений щелкните правой кнопкой мыши исходные файлы, наведите указатель мыши на пункт Добавить, а затем выберите пункт Создать элемент.

      Откроется диалоговое окно Добавление нового элемента.

    2. Разверните узел Visual C++ в области Категории и щелкните Код.

    3. В области Шаблоны выберите шаблон Файл C++ .

    4. В поле Имя введите HelloWorld и оставьте путь к файлу по умолчанию в поле Расположение .

    5. Нажмите кнопку Добавить.

    6. Добавьте следующий код:

      #define _WINSOCKAPI_
#include <windows.h>
#include <sal.h>
#include <httpserv.h>

// Create the module's global class.
class MyGlobalModule : public CGlobalModule
{
public:

    // Process a GL_APPLICATION_START notification.
    GLOBAL_NOTIFICATION_STATUS
    OnGlobalPreBeginRequest(
        IN IPreBeginRequestProvider * pProvider
    )
    {
        UNREFERENCED_PARAMETER( pProvider );
        WriteEventViewerLog( "Hello World!" );
        return GL_NOTIFICATION_CONTINUE;
    }

    VOID Terminate()
    {
        // Remove the class from memory.
        delete this;
    }

    MyGlobalModule()
    {
        // Open a handle to the Event Viewer.
        m_hEventLog = RegisterEventSource( NULL,"IISADMIN" );
    }

    ~MyGlobalModule()
    {
        // Test whether the handle for the Event Viewer is open.
        if (NULL != m_hEventLog)
        {
            // Close the handle to the Event Viewer.
            DeregisterEventSource( m_hEventLog );
            m_hEventLog = NULL;
        }
    }

private:

    // Create a handle for the event viewer.
    HANDLE m_hEventLog;

    // Define a method that writes to the Event Viewer.
    BOOL WriteEventViewerLog(LPCSTR szNotification)
    {
        // Test whether the handle for the Event Viewer is open.
        if (NULL != m_hEventLog)
        {
            // Write any strings to the Event Viewer and return.
            return ReportEvent(
                m_hEventLog,
                EVENTLOG_INFORMATION_TYPE, 0, 0,
                NULL, 1, 0, &szNotification, NULL );
        }
        return FALSE;
    }
};

// Create the module's exported registration function.
HRESULT
__stdcall
RegisterModule(
    DWORD dwServerVersion,
    IHttpModuleRegistrationInfo * pModuleInfo,
    IHttpServer * pGlobalInfo
)
{
    UNREFERENCED_PARAMETER( dwServerVersion );
    UNREFERENCED_PARAMETER( pGlobalInfo );

    // Create an instance of the global module class.
    MyGlobalModule * pGlobalModule = new MyGlobalModule;
    // Test for an error.
    if (NULL == pGlobalModule)
    {
        return HRESULT_FROM_WIN32(ERROR_NOT_ENOUGH_MEMORY);
    }
    // Set the global notifications and exit.
    return pModuleInfo->SetGlobalNotifications(
        pGlobalModule, GL_PRE_BEGIN_REQUEST );
}

  4. При необходимости можно скомпилировать код с помощью соглашения о вызовах __stdcall (/Gz) :

    1. В меню Проект выберите свойства HelloWorld.

    2. Разверните узел Свойства конфигурации в представлении дерева, разверните узел C/C++ и нажмите кнопку Дополнительно.

    3. В раскрывающемся списке Конфигурация выберите Все конфигурации.

    4. В раскрывающемся списке Соглашение о вызовах выберите __stdcall (/Gz).

    5. Нажмите кнопку ОК.

Компиляция и тестирование модуля

В модуле HTTP есть все необходимое. Все, что требуется, — это компиляция и тестирование модуля HTTP.

Компиляция и тестирование проекта

  1. Скомпилируйте модуль HTTP:

    1. В меню Сборка выберите Собрать решение.

    2. Убедитесь, что Visual Studio не вернул никаких ошибок или предупреждений. При возникновении ошибок или предупреждений необходимо устранить эти проблемы перед тестированием проекта.

  2. Скопируйте DLL-файл для модуля HTTP в папку IIS:

    1. Откройте windows Обозреватель и найдите папку по умолчанию, указанную при создании проекта C++.

      В зависимости от параметров сборки в папке по умолчанию для проекта должна появиться папка с именем Debug или Release.

    2. В папке Отладка или Выпуск найдите файл с именем HelloWorld.dll.

    3. Скопируйте файл HelloWorld.dll в папку Inetsrv, которая по умолчанию находится в папке %WinDir%\System32\Inetsrv.

  3. Добавьте модуль HelloWorld.dll в список модулей (инструкции см. в разделе Проектирование модулей Native-Code HTTP).

  4. Используйте интернет-Обозреватель для перехода на веб-сайт. Вы должны увидеть обычное содержимое веб-сайта.

  5. Откройте Просмотр событий Windows и перейдите к глобальному журналу приложений. Вы увидите запись, в которую в качестве источника событий указан "IISADMIN".

  6. Щелкните событие правой кнопкой мыши и выберите пункт Свойства , чтобы просмотреть сведения о событии. В области описания должно отобразиться сообщение "Hello World!".

Устранение неполадок с параметрами

Если модуль не компилируется или не работает должным образом, можно проверка несколько областей:

  • Убедитесь, что вы указали __stdcall для экспортированных функций или что вы настроили компиляцию с помощью соглашения о вызовах __stdcall (/Gz) .

  • Убедитесь, что вы добавили правильный RegisterModule экспорт в файл определения.

  • Убедитесь, что вы добавили файл определения в параметры проекта. Чтобы добавить файл в параметры проекта, выполните следующие действия.

    1. В меню Проект выберите Свойства.

    2. Разверните узел Свойства конфигурации в представлении дерева, узел Компоновщик и нажмите кнопку Входные данные.

    3. Для параметров Файл определения модуля убедитесь, что файл определения указан в списке.

См. также раздел