title | description | ms.date | ms.assetid |
---|---|---|---|
IHttpContext::GetParentContext Method |
The IHttpContextGetParentContext method retrieves a pointer to the parent context for the current context. |
10/07/2016 |
99ef993a-b8a5-71d4-0223-f3d2acf489c8 |
Retrieves a pointer to the parent context for the current context.
virtual IHttpContext* GetParentContext(
VOID
) const = 0;
This method takes no parameters.
A pointer to an IHttpContext interface.
The GetParentContext
method retrieves a pointer to the IHttpContext
interface for the parent context of the current request. For example, if an HTTP module creates a child context by using the CloneContext method, the GetParentContext
method can help determine whether the module is processing on the parent context or on the child context.
Note
When the current context does not have a parent context, the GetParentContext
method will return NULL
.
The following code example demonstrates how to use the GetParentContext
method to create an HTTP module that retrieves the parent context for the request. The module compares the parent context with NULL
and the current request context to determine whether the parent context is different than the current context. The module then returns a message to the Web client and exits.
[!code-cppIHttpContextGetParentContext#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.
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 |
IHttpContext Interface
IHttpContext::CloneContext Method
IHttpContext::GetRootContext Method