| title | IHttpResponse::DisableBuffering Method |
|---|---|
| description | Learn how the DisableBuffering method disables response buffering for the current request. |
| ms.date | 10/07/2016 |
| ms.assetid | 20bd4ed1-77a9-edd0-dae9-0cc77a1876ec |
Disables response buffering for the current request.
virtual VOID DisableBuffering(
VOID
) = 0; This method takes no parameters.
VOID.
[!INCLUDEiisver] contains a response buffering feature that is turned on by default, but you can disable it by using the DisableBuffering method. With buffering enabled, IIS builds the entire response in memory before it returns any data to a Web client. This increases network performance, but there may be situations where you want to disable buffering. For example, if you are writing an application that requires a long period of time to complete, a Web client will have to wait until the response has been completely built and returned by IIS before the client sees any data. With buffering disabled, the Web client will see data incrementally as it is returned by IIS.
Note
The DisableBuffering method does not disable buffering for the CHttpModule::OnSendResponse method.
The following code example demonstrates how to use the DisableBuffering method to create an HTTP module that disables response buffering for the current request.
[!code-cppIHttpResponseDisableBuffering#1]
Your module must export the RegisterModule function. You can export this function by creating a module definition (.def) file for your project, or you can compile the module by using the /EXPORT:RegisterModule switch. For more information, see Walkthrough: Creating a Request-Level HTTP Module By Using Native Code.
You can compile the code by using the __stdcall (/Gz) calling convention instead of explicitly declaring the calling convention for each function.
| Type | Description |
|---|---|
| Client | - IIS 7.0 on [!INCLUDEwinvista] - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10 |
| Server | - IIS 7.0 on [!INCLUDEwinsrv2008] - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016 |
| Product | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - [!INCLUDEiisexp75], [!INCLUDEiisexp80], [!INCLUDEiisexp100] |
| Header | Httpserv.h |