Metode IPreBeginRequestProvider::GetHttpContext

Mengambil antarmuka IHttpContext .

Sintaks

virtual IHttpContext* GetHttpContext(  
   VOID  
) = 0;  

Parameter

Metode ini tidak memerlukan parameter.

Tampilkan Nilai

Penunjuk ke IHttpContext.

Keterangan

Metode ini GetHttpContext mengambil penunjuk ke antarmuka IHttpContext , yang memungkinkan pemberitahuan tingkat global mengakses konteks untuk permintaan. Ini berbeda dengan pemberitahuan tingkat permintaan, di mana pointer ke IHttpContext antarmuka disediakan.

Contoh

Contoh kode berikut menunjukkan cara membuat modul HTTP tingkat global yang menggunakan GetHttpContext fungsi untuk mengambil pointer ke IHttpContext antarmuka. Modul ini memanggil metode IHttpContext::GetSite konteks untuk mengambil pointer ke antarmuka IHttpSite , lalu memanggil metode IHttpSite::GetSiteName untuk mengambil nama situs yang sedang memproses permintaan.

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

// Create the module's global class.
class MyGlobalModule : public CGlobalModule
{
public:
    GLOBAL_NOTIFICATION_STATUS
    OnGlobalPreBeginRequest(
        IN IPreBeginRequestProvider * pProvider
    )
    {
        UNREFERENCED_PARAMETER( pProvider );

        // Retrieve a pointer to the IHttpContext for the request.
        IHttpContext * pHttpContext = pProvider->GetHttpContext();
        // Test for an error.
        if (NULL != pHttpContext)
        {
            // Retrieve a pointer to an IHttpSite class.
            IHttpSite * pHttpSite = pHttpContext->GetSite();
            // Test for an error.
            if (NULL != pHttpSite)
            {
                // Retrieve the site name.
                PCWSTR pwszSiteName = pHttpSite->GetSiteName();
                // Test for an error.
                if (NULL != pwszSiteName)
                {
                    // Allocate storage for the site name.
                    char * pszSiteName =
                        (char *) pHttpContext->AllocateRequestMemory(
                        (DWORD) wcslen(pwszSiteName)+1 );
                    // Test for an error.
                    if (NULL != pszSiteName)
                    {
                        // Convert the site name.
                        wcstombs(pszSiteName,pwszSiteName,
                            wcslen(pwszSiteName));
                        // Create an array of strings.
                        LPCSTR szBuffer[2] = {"Site Name",""};
                        // Store the site name.
                        szBuffer[1] = pszSiteName;
                        // Write the strings to the Event Viewer.
                        WriteEventViewerLog(szBuffer,2);
                    }
                }
            }
        }
        // Return processing to the pipeline.
        return GL_NOTIFICATION_CONTINUE;
    }

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

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

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

private:

    // Handle for the Event Viewer.
    HANDLE m_hEventLog;

    // Define a method that writes to the Event Viewer.
    BOOL WriteEventViewerLog(LPCSTR szBuffer[], WORD wNumStrings)
    {
        // Test whether the handle for the Event Viewer is open.
        if (NULL != MyGlobalModule::m_hEventLog)
        {
            // Write any strings to the Event Viewer and return.
            return ReportEvent(
                MyGlobalModule::m_hEventLog,
                EVENTLOG_INFORMATION_TYPE,
                0, 0, NULL, wNumStrings,
                0, szBuffer, 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 );
}

Modul Anda harus mengekspor fungsi RegisterModule . Anda dapat mengekspor fungsi ini dengan membuat file definisi modul (.def) untuk proyek Anda, atau Anda dapat mengkompilasi modul dengan menggunakan sakelar /EXPORT:RegisterModule . Untuk informasi selengkapnya, lihat Panduan: Membuat Modul HTTP Request-Level Dengan Menggunakan Kode Asli.

Anda dapat secara opsional mengkompilasi kode dengan menggunakan __stdcall (/Gz) konvensi panggilan alih-alih secara eksplisit mendeklarasikan konvensi panggilan untuk setiap fungsi.

Persyaratan

Jenis	Deskripsi
Klien	- IIS 7.0 di Windows Vista - IIS 7.5 di Windows 7 - IIS 8.0 di Windows 8 - IIS 10.0 pada Windows 10
Server	- IIS 7.0 di Windows Server 2008 - IIS 7.5 di Windows Server 2008 R2 - IIS 8.0 di Windows Server 2012 - IIS 8.5 di Windows Server 2012 R2 - IIS 10.0 di Windows Server 2016
Produk	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Header	Httpserv.h

Lihat juga

Antarmuka IPreBeginRequestProvider