ihttpcontext-getresponse-method.md

title	description	ms.date	ms.assetid
IHttpContext::GetResponse Method	Learn how the IHttpContext::GetResponse method returns the HTTP response container for the current context.	10/07/2016	c89e2994-acc9-5d9f-54c4-76d16d87f0fa

IHttpContext::GetResponse Method

Returns the HTTP response container for the current context.

Syntax

virtual IHttpResponse* GetResponse(  
   VOID  
) = 0;  

Parameters

This method takes no parameters.

Return Value

A pointer to an IHttpResponse interface.

Remarks

The GetResponse method returns a pointer to an IHttpResponse interface that can be used to call any of the IHttpResponse methods.

Note

The HTTP context object owns the lifetime of this object. Therefore, you do not free this pointer when writing HTTP modules.

Example

The following code example illustrates how to use the IHttpContext::GetResponse and GetRequest methods to return pointers to IHttpResponse and IHttpRequest interfaces. This example also demonstrates how to use the IHttpRequest::GetHttpMethod method to retrieve the HTTP method for the current request, and it displays the method to a Web client by using the IHttpResponse::WriteEntityChunks method.

[!code-cppIHttpContextGetResponse#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

IHttpContext Interface
IHttpContext::GetRequest Method