次の方法で共有

チュートリアル: ネイティブ コードを使用した Global-Level HTTP モジュールの作成

このチュートリアルでは、C++ を使用して、IIS 7 で新しい要求処理アーキテクチャを実装するサンプルグローバル レベルの HTTP モジュールを作成する方法について説明します。 この新しいアーキテクチャでは、以前のバージョンの ASP.NET HTTP モジュールと ISAPI フィルターまたは拡張機能を使用して IIS アプリケーションを記述する場合に、ネイティブ コード プログラミングの機能が拡張されます。 新しい要求処理アーキテクチャを使用した HTTP モジュールの設計の詳細については、「 Native-Code HTTP モジュールの設計」を参照してください。

このチュートリアルでは、HTTP モジュールの C++ プロジェクトを作成し、"Hello World" プロジェクトに必要なコードを追加してから、モジュールをコンパイルしてテストします。

前提条件

この例の手順を完了するには、次のソフトウェアが必要です。

  • IIS 7。

  • Visual Studio 2005。

注

Visual Studio .NET 2003 以前を使用することもできますが、チュートリアルの手順は同じでない場合があります。

モジュールの作成

チュートリアルのこの部分では、HTTP モジュール用の空の C++ DLL プロジェクトを作成します。

新しい C++ DLL プロジェクトを作成するには

  1. Visual Studio 2005 を起動します。

  2. グローバル オプションに SDK インクルード ファイルへの適切なパスがすべて含まれているかどうかを確認します。

    1. [ツール] メニューの [オプション] をクリックします。

    2. ツリー ビューで [ プロジェクトとソリューション] ノードを展開し、[ VC++ ディレクトリ] をクリックします。

    3. [ ディレクトリを表示する] ドロップダウン ボックスで、[ ファイルを含める] を選択します。

    4. SDK インクルード ファイルをインストールしたパスが一覧表示されていることを確認します。 パスが一覧にない場合は、[ 新しい行 ] アイコンをクリックし、SDK インクルード ファイルをインストールしたパスを追加します。

    5. OK をクリックします。

  3. 新しい C++ プロジェクトを作成します。

    1. [ファイル] メニューの [新規作成] をポイントし、 [プロジェクト] をクリックします。

      新しいプロジェクト ダイアログ ボックスが開きます。

    2. [ プロジェクトの種類 ] ウィンドウで、[ Visual C++ ] ノードを展開し、[ Win32] をクリックします。

    3. [テンプレート] ウィンドウ で 、[ Win32 プロジェクト] を選択します。

    4. [ 名前 ] ボックスに「 HelloWorld」と入力します。

    5. [ 場所 ] ボックスに、サンプルのパスを入力します。

    6. OK をクリックします。

      Win32 アプリケーション ウィザードが開きます。

    7. [ アプリケーション設定] をクリックします。

    8. [ アプリケーションの種類] で 、[ DLL] をクリックします。

    9. [ その他のオプション] で、[ 空のプロジェクト] をクリックします。

    10. [完了] をクリックします。

コード ファイルとソース ファイルの追加

次の手順では、必要な C++ ファイルとモジュール定義ファイルをプロジェクトに追加します。

ソース ファイルをプロジェクトに追加するには

  1. RegisterModule 関数をエクスポートするモジュール定義ファイルを作成します。

    1. ソリューション エクスプローラーで、[ ソース ファイル] を右クリックし、[ 追加] をポイントして、[ 新しい項目] をクリックします。

      [新しい項目の追加] ダイアログ ボックスが開きます。

    2. [カテゴリ] ウィンドウで [Visual C++] ノードを展開し、[コード] をクリックします。

    3. [テンプレート] ウィンドウ で 、 Module-Definition ファイル テンプレートを 選択します。

    4. [ 名前 ] ボックスに 「HelloWorld」と入力し、[ 場所 ] ボックスにファイルの既定のパスのままにします。

    5. 追加をクリックします。

    6. 次のコードを追加します。

      LIBRARY HelloWorld  

EXPORTS  
    RegisterModule

  2. 必要に応じて、/EXPORT:RegisterModule スイッチを使用して RegisterModule 関数をエクスポートできます。

    1. [ プロジェクト ] メニューの [ HelloWorld のプロパティ] をクリックします。

    2. ツリー ビューで [構成プロパティ] ノードを展開し、[ リンカー ] ノードを展開して、[ コマンド ライン] をクリックします。

    3. [ 構成 ] ドロップダウン ボックスで、[ すべての構成] を選択します。

    4. [ 追加オプション ] ボックスに、「 /EXPORT:RegisterModule」と入力します。

    5. OK をクリックします。

  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. OK をクリックします。

モジュールのコンパイルとテスト

HTTP モジュールには、必要なものがすべて含まれています。 必要なのは、HTTP モジュールをコンパイルしてテストする方法です。

プロジェクトをコンパイルしてテストするには

  1. HTTP モジュールをコンパイルします。

    1. [ビルド] メニューの [ソリューションのビルド] をクリックします。

    2. Visual Studio がエラーや警告を返さなかったことを確認します。 エラーまたは警告が発生した場合は、プロジェクトをテストする前に、これらの問題を解決する必要があります。

  2. HTTP モジュールの DLL ファイルを IIS フォルダーにコピーします。

    1. Windows エクスプローラーを開き、C++ プロジェクトの作成時に指定された既定のフォルダーを見つけます。

      ビルド オプションに応じて、プロジェクトの既定のフォルダーに Debug または Release という名前のフォルダーが表示されます。

    2. Debug フォルダーまたは Release フォルダー内で、HelloWorld.dllという名前のファイルを見つけます。

    3. HelloWorld.dll ファイルを Inetsrv フォルダーにコピーします。このフォルダーは、既定で \System32\Inetsrv %WinDir%にあります。

  3. HelloWorld.dll モジュールをモジュールの一覧に追加します (手順については、「 Native-Code HTTP モジュールの設計」を参照してください)。

  4. Internet Explorer を使用して Web サイトを参照します。通常の Web サイトのコンテンツが表示されます。

  5. Windows イベント ビューアーを開き、グローバル アプリケーション ログに切り替えます。"IISADMIN" をイベント ソースとして一覧表示するエントリが表示されます。

  6. イベントを右クリックし、[ プロパティ ] をクリックしてイベントの詳細を表示します。 [説明] ウィンドウに "Hello World!" というメッセージが表示されます。

設定のトラブルシューティング

モジュールがコンパイルされない場合、または期待どおりに動作しない場合は、確認できるいくつかの領域を次に示します。

  • エクスポートした関数の __stdcall を指定していること、または __stdcall (/Gz) 呼び出し規則を使用してコンパイルを構成していることを確認します。

  • 正しい RegisterModule エクスポートが定義ファイルに追加されていることを確認します。

  • プロジェクト設定に定義ファイルが追加されていることを確認します。 プロジェクト設定にファイルを追加するには、次の手順を実行します。

    1. プロジェクト メニューで、プロパティをクリックします。

    2. ツリー ビューで [構成プロパティ] ノードを展開し、[ リンカー ] ノードを展開して、[ 入力] をクリックします。

    3. モジュール定義ファイルの設定では、定義ファイルが一覧表示されていることを確認します。

こちらも参照ください

  • Last updated on