httpgetextendedinterface-function.md

title	description	ms.date	ms.assetid
HttpGetExtendedInterface Function	Describes the HttpGetExtendedInterface function and provides the function's syntax, return value, remarks, and requirements.	10/07/2016	89120dc5-2cae-46a5-82b0-f2a06bc6a7eb

HttpGetExtendedInterface Function

Retrieves an extended HTTP interface given the HTTP server instance and the pointer to be down cast.

Syntax

template <class HttpType1, class HttpType2>  
HRESULT HttpGetExtendedInterface(  
   __in IHttpServer* pHttpServer,  
   __in HttpType1* pInput,  
   __deref_out HttpType2** ppOutput  
);  

Parameters

pHttpServer
[IN] Points to an instance of the IHttpServer interface.

pInput
[IN] Points to an instance of the interface to be down cast.

ppOutput
[OUT] Points to the extended HTTP interface.

Return Value

An HRESULT. Possible values include, but are not limited to, those in the following table.

Value	Description
S_OK	Indicates that the operation was successful.

Remarks

Template parameters (HttpType1 and HttpType2) can be deduced from the arguments to the function, as shown in the following example.

IHttpRequest * pHttpRequest = pHttpContext->GetRequest();  
IHttpRequest2 * pHttpRequest2;  
HRESULT hr = HttpGetExtendedInterface(g_pHttpServer, pHttpRequest, &pHttpRequest2);  
if( SUCCEEDED(hr) )  
{  
    // Use pHttpRequest2.  
}  

Where pHttpContext is an IHttpContext pointer and g_pHttpServer is an IHttpServer pointer.

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

Web Server Core Functions