Skip to content

ihttpresponse-getheaderssuppressed-method.md

Latest commit

 

History

History
47 lines (35 loc) · 3.54 KB

ihttpresponse-getheaderssuppressed-method.md

File metadata and controls

47 lines (35 loc) · 3.54 KB
title IHttpResponse::GetHeadersSuppressed Method
description Describes the IHttpResponse::GetHeadersSuppressed method and details its syntax, parameters, return value, remarks, code example, and requirements.
ms.date 10/07/2016
ms.assetid 6af99349-7a65-f42c-e9b7-3ee6b795632d

IHttpResponse::GetHeadersSuppressed Method

Determines whether the response status and headers are suppressed.

Syntax

virtual BOOL GetHeadersSuppressed(  
   VOID  
) const = 0;

Parameters

This method takes no parameters.

Return Value

true if the headers are suppressed; otherwise, false.

Remarks

The GetHeadersSuppressed method determines whether the HTTP status and headers have been suppressed for this response. This method is helpful in determining whether another application has called the IHttpResponse::SuppressHeaders method.

Example

The following code example demonstrates how to use the GetHeadersSuppressed method to create an HTTP module that determines whether the headers are currently suppressed. The module calls the SuppressHeaders method to prevent the default HTTP headers from being sent to the client, and then it uses the IHttpResponse::WriteEntityChunks method to return a raw HTTP response to the client.

[!code-cppIHttpResponseGetHeadersSuppressed#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 optionally compile the code by using the __stdcall (/Gz) calling convention instead of explicitly declaring the calling convention for each function.

Requirements

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

See Also

IHttpResponse Interface
IHttpResponse::SuppressHeaders Method