IHttpServer::IncrementThreadCount-Methode

Artikel
07/19/2023

Erhöht die Threadanzahl für den Threadpool.

Syntax

virtual VOID IncrementThreadCount(  
   VOID  
) = 0;

Parameter

Diese Methode nimmt zwei Parameter entgegen.

Rückgabewert

VOID.

Bemerkungen

Die IncrementThreadCount -Methode erhöht die Anzahl der verfügbaren Threads für den Threadpool um einen einzelnen Thread. Die Anzahl überschreitet nicht den maximalen Grenzwert für den Threadpool von 256 Threads.

Hinweis

IncrementThreadCount erhöht die Anzahl der verwendeten Threads nicht; nur die Threadanzahl ist betroffen.

Wenn Sie ein HTTP-Modul entwickeln, das Vorgänge ausführt, für die eine lange Verarbeitungszeit erforderlich ist, kann Ihr HTTP-Modul aufrufen IncrementThreadCount , um die verfügbaren Threads für den Threadpool zu erhöhen, während Ihr Modul Ihre zeitintensiven Vorgänge ausführt. Wenn das Modul fertig ist, ruft es IIHttpServer::D ecrementThreadCount auf, um die Threadanzahl wiederherzustellen.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie sie ein HTTP-Modul erstellen, das aufruft IncrementThreadCount , um die Threadanzahl für den Threadpool zu erhöhen und dann 30 Sekunden lang in den Standbymodus zu schalten. Das Modul ruft dann auf DecrementThreadCount , um die Threadanzahl wiederherzustellen und die Beendigungen durchzuführen.

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

// Create a pointer for the global server interface.
IHttpServer * g_pHttpServer = NULL;

// Create the module class.
class MyHttpModule : public CHttpModule
{
public:
    REQUEST_NOTIFICATION_STATUS
    OnBeginRequest(
        IN IHttpContext * pHttpContext,
        IN IHttpEventProvider * pProvider
    )
    {
        UNREFERENCED_PARAMETER( pHttpContext );
        UNREFERENCED_PARAMETER( pProvider );

        // Increment the thread count.
        g_pHttpServer->IncrementThreadCount();

        // Sleep for 30 seconds.
        Sleep(30 * 1000);

        // Decrement the thread count.
        g_pHttpServer->DecrementThreadCount();

        // Return processing to the pipeline.
        return RQ_NOTIFICATION_CONTINUE;
    }
};

// Create the module's class factory.
class MyHttpModuleFactory : public IHttpModuleFactory
{
public:
    HRESULT
    GetHttpModule(
        OUT CHttpModule ** ppModule, 
        IN IModuleAllocator * pAllocator
    )
    {
        UNREFERENCED_PARAMETER( pAllocator );

        // Create a new instance.
        MyHttpModule * pModule = new MyHttpModule;

        // Test for an error.
        if (!pModule)
        {
            // Return an error if the factory cannot create the instance.
            return HRESULT_FROM_WIN32( ERROR_NOT_ENOUGH_MEMORY );
        }
        else
        {
            // Return a pointer to the module.
            *ppModule = pModule;
            pModule = NULL;
            // Return a success status.
            return S_OK;
        }            
    }

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

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

    // Store the pointer for the global server interface.
    g_pHttpServer = pGlobalInfo;

   // Set the request notifications and exit.
    return pModuleInfo->SetRequestNotifications(
        new MyHttpModuleFactory,
        RQ_BEGIN_REQUEST,
        0
    );
}

Ihr Modul muss die RegisterModule-Funktion exportieren. Sie können diese Funktion exportieren, indem Sie eine Moduldefinitionsdatei (.def) für Ihr Projekt erstellen, oder Sie können das Modul mithilfe des Schalters /EXPORT:RegisterModule kompilieren. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Request-Level HTTP-Moduls mithilfe von nativem Code.

Sie können den Code optional kompilieren, indem Sie die __stdcall (/Gz) Aufrufkonvention verwenden, anstatt die Aufrufkonvention für jede Funktion explizit zu deklarieren.

Anforderungen

type	BESCHREIBUNG
Client	– IIS 7.0 unter Windows Vista – IIS 7.5 unter Windows 7 – IIS 8.0 unter Windows 8 – IIS 10.0 unter Windows 10
Server	– IIS 7.0 unter Windows Server 2008 – IIS 7.5 unter Windows Server 2008 R2 – IIS 8.0 unter Windows Server 2012 – IIS 8.5 unter Windows Server 2012 R2 – IIS 10.0 unter Windows Server 2016
Produkt	– 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

Weitere Informationen

IHttpServer-Schnittstelle
IHttpServer::D ecrementThreadCount-Methode

Freigeben über