IHttpResponse::D isableBuffering, méthode

Article
07/19/2023

Désactive la mise en mémoire tampon des réponses pour la requête actuelle.

Syntaxe

virtual VOID DisableBuffering(  
   VOID  
) = 0;

Paramètres

Cette méthode ne prend aucun paramètre.

Valeur renvoyée

VOID.

Remarques

IIS 7 contient une fonctionnalité de mise en mémoire tampon de réponse activée par défaut, mais vous pouvez la désactiver à l’aide de la DisableBuffering méthode . Une fois la mise en mémoire tampon activée, IIS génère l’intégralité de la réponse en mémoire avant de retourner des données à un client Web. Cela augmente les performances du réseau, mais il peut arriver que vous souhaitiez désactiver la mise en mémoire tampon. Par exemple, si vous écrivez une application qui nécessite une longue période d’exécution, un client Web doit attendre que la réponse ait été entièrement générée et retournée par IIS avant que le client ne voit les données. Une fois la mise en mémoire tampon désactivée, le client Web voit les données de manière incrémentielle à mesure qu’elles sont retournées par IIS.

Notes

La DisableBuffering méthode ne désactive pas la mise en mémoire tampon pour la méthode CHttpModule::OnSendResponse .

Exemple

L’exemple de code suivant montre comment utiliser la DisableBuffering méthode pour créer un module HTTP qui désactive la mise en mémoire tampon des réponses pour la requête actuelle.

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

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

        // Retrieve a pointer to the response.
        IHttpResponse * pHttpResponse =
            pHttpContext->GetResponse();

        // Test for an error.
        if (pHttpResponse != NULL)
        {
            // Disable buffering for this response.
            pHttpResponse->DisableBuffering();
        }

        // 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 );
    UNREFERENCED_PARAMETER( pGlobalInfo );

    return pModuleInfo->SetRequestNotifications(
        new MyHttpModuleFactory,
        RQ_BEGIN_REQUEST,
        0
    );
}

Votre module doit exporter la fonction RegisterModule . Vous pouvez exporter cette fonction en créant un fichier de définition de module (.def) pour votre projet, ou vous pouvez compiler le module à l’aide du /EXPORT:RegisterModule commutateur . Pour plus d’informations, consultez Procédure pas à pas : création d’un module HTTP Request-Level à l’aide de code natif.

Vous pouvez compiler le code à l’aide de la __stdcall (/Gz) convention d’appel au lieu de déclarer explicitement la convention d’appel pour chaque fonction.

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sur Windows 8 - IIS 10.0 sur Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016
Produit	- 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
En-tête	Httpserv.h

Voir aussi

IHttpResponse, interface

Partager via