Panduan: Membuat Modul HTTP Global-Level Dengan Menggunakan Kode Asli

Panduan ini menunjukkan cara menggunakan C++ untuk membuat sampel modul HTTP tingkat global yang mengimplementasikan arsitektur pemrosesan permintaan baru di IIS 7. Arsitektur baru ini memperluas kemampuan pemrograman kode asli saat Anda menulis aplikasi IIS melalui versi modul HTTP ASP.NET yang lebih lama dan filter atau ekstensi ISAPI. Untuk informasi selengkapnya tentang mendesain modul HTTP menggunakan arsitektur pemrosesan permintaan baru, lihat Merancang modul HTTP Native-Code.

Dalam panduan ini, Anda akan membuat proyek C++ untuk modul HTTP Anda, menambahkan kode yang diperlukan untuk proyek "Halo Dunia", lalu mengkompilasi dan menguji modul.

Prasyarat

Perangkat lunak berikut diperlukan untuk menyelesaikan langkah-langkah dalam contoh:

IIS 7.
Visual Studio 2005.

Catatan

Anda juga dapat menggunakan Visual Studio .NET 2003 atau yang lebih lama, meskipun langkah-langkah penelusuran mungkin tidak identik.

Membuat Modul

Di bagian panduan ini, Anda akan membuat proyek C++ DLL kosong untuk modul HTTP Anda.

Untuk membuat proyek C++ DLL baru

Mulai Visual Studio 2005.
Verifikasi bahwa opsi global memiliki semua jalur yang tepat ke SDK termasuk file:
1. Di menu Alat, klik Opsi.
2. Perluas simpul Proyek dan Solusi dalam tampilan pohon, lalu klik Direktori VC++.
3. Dalam kotak drop-down Perlihatkan direktori untuk , pilih Sertakan file.
4. Verifikasi bahwa jalur tempat Anda menginstal file sertakan SDK tercantum. Jika jalur tidak tercantum, klik ikon Baris Baru , lalu tambahkan jalur tempat Anda menginstal SDK menyertakan file.
5. Klik OK.
Buat proyek C++ baru:
1. Pada menu File, arahkan ke Baru, lalu klik Proyek.
  
  Kotak dialog Proyek Baru terbuka.
2. Di panel Jenis Proyek , perluas simpul Visual C++ , lalu klik Win32.
3. Di panel Templat , pilih Proyek Win32.
4. Dalam kotak Nama , ketik HelloWorld.
5. Dalam kotak Lokasi , ketik jalur untuk sampel.
6. Klik OK.
  
  Panduan Aplikasi Win32 terbuka.
7. Klik Pengaturan Aplikasi.
8. Di bawah Jenis aplikasi, klik DLL.
9. Di bawah Opsi tambahan, klik Kosongkan proyek.
10. Klik Selesai.

Menambahkan Kode dan File Sumber

Langkah selanjutnya adalah menambahkan C++ dan file definisi modul yang diperlukan ke proyek.

Untuk menambahkan file sumber ke proyek

Buat file definisi modul untuk mengekspor fungsi RegisterModule :
1. Di Penjelajah Solusi, klik kanan File Sumber, arahkan ke Tambahkan, lalu klik Item Baru.
  
  Kotak dialog Tambahkan Item Baru terbuka.
2. Perluas simpul Visual C++ di panel Kategori , lalu klik Kode.
3. Di panel Templat , pilih templat File Definisi Modul .
4. Dalam kotak Nama , ketik HelloWorld, dan biarkan jalur default untuk file di kotak Lokasi .
5. Klik Tambahkan.
6. Tambahkan kode berikut:
```
LIBRARY HelloWorld  

EXPORTS  
    RegisterModule  
```
Anda dapat secara opsional mengekspor fungsi RegisterModule dengan menggunakan sakelar /EXPORT:RegisterModule :
1. Pada menu Proyek , klik HelloWorld Properties.
2. Perluas simpul Properti Konfigurasi dalam tampilan pohon, perluas simpul Linker , lalu klik Baris Perintah.
3. Di kotak drop-down Konfigurasi , pilih Semua Konfigurasi.
4. Dalam kotak Opsi Tambahan , ketik /EXPORT:RegisterModule.
5. Klik OK.

Buat file C++:

Di Penjelajah Solusi, klik kanan File Sumber, arahkan ke Tambahkan, lalu klik Item Baru.

Kotak dialog Tambahkan Item Baru terbuka.
Perluas simpul Visual C++ di panel Kategori , lalu klik Kode.
Di panel Templat , pilih templat File C++ .
Dalam kotak Nama , ketik HelloWorld, dan biarkan jalur default untuk file di kotak Lokasi .
Klik Tambahkan.

Tambahkan kode berikut:

#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 );
}

Anda dapat secara opsional mengkompilasi kode dengan menggunakan __stdcall (/Gz) konvensi panggilan:
1. Pada menu Proyek , klik HelloWorld Properties.
2. Perluas simpul Properti Konfigurasi dalam tampilan pohon, perluas simpul C/C++ , lalu klik Tingkat Lanjut.
3. Di kotak drop-down Konfigurasi , pilih Semua Konfigurasi.
4. Dalam kotak drop-down Konvensi Panggilan , pilih __stdcall (/Gz).
5. Klik OK.

Mengkompilasi dan Menguji Modul

Modul HTTP Anda memiliki semua yang dibutuhkan. Yang diperlukan hanyalah mengkompilasi dan menguji modul HTTP Anda.

Untuk mengkompilasi dan menguji proyek

Kompilasi modul HTTP:
1. Pada menu Build, klik Solusi Build.
2. Verifikasi bahwa Visual Studio tidak mengembalikan kesalahan atau peringatan apa pun. Jika Anda mengalami kesalahan atau peringatan, Anda harus menyelesaikan masalah tersebut sebelum menguji proyek.
Salin file DLL untuk modul HTTP ke folder IIS Anda:
1. Buka Windows Explorer dan temukan folder default yang ditentukan saat Anda membuat proyek C++.
  
  Bergantung pada opsi build, Anda akan melihat folder bernama Debug atau Rilis di folder default untuk proyek Anda.
2. Di dalam folder Debug atau Rilis, temukan file bernama HelloWorld.dll.
3. Salin file HelloWorld.dll ke folder Inetsrv Anda, yang terletak secara default di %WinDir%\System32\Inetsrv.
Tambahkan modul HelloWorld.dll ke daftar modul Anda (untuk instruksi, lihat Merancang modul HTTP Native-Code).
Gunakan Internet Explorer untuk menelusuri situs Web Anda; Anda akan melihat isi situs Web normal Anda.
Buka Windows Event Viewer dan beralihlah ke log aplikasi global; Anda akan melihat entri yang mencantumkan "IISADMIN" sebagai sumber kejadian.
Klik kanan peristiwa, lalu klik Properti untuk melihat detail peristiwa. Anda akan melihat pesan "Halo Dunia!" ditampilkan di panel Deskripsi.

Pemecahan Masalah Pengaturan Anda

Jika modul Anda tidak dikompilasi atau tidak berfungsi seperti yang diharapkan, berikut adalah beberapa area yang dapat Anda periksa:

Pastikan Anda telah menentukan __stdcall untuk fungsi yang diekspor, atau Anda telah mengonfigurasi kompilasi dengan menggunakan __stdcall (/Gz) konvensi panggilan.
Pastikan Anda telah menambahkan ekspor yang benar RegisterModule ke file definisi Anda.
Pastikan Anda telah menambahkan file definisi ke pengaturan proyek. Untuk menambahkan file ke pengaturan proyek, selesaikan langkah-langkah berikut:
1. Pada menu Proyek, klik Properti.
2. Perluas simpul Properti Konfigurasi dalam tampilan pohon, perluas simpul Linker , lalu klik Input.
3. Untuk pengaturan File Definisi Modul , pastikan file definisi Anda tercantum.

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2023-07-19