chttpmodule-onmappath-method.md

title	CHttpModule::OnMapPath Method
description	CHttpModule::OnMapPath Method represents the method that will handle a MapPath event, which occurs when an operation requests the physical path to be mapped for the current request.
ms.date	10/07/2016
ms.assetid	4c9cdb28-6efc-67d0-31d1-7fe043851a45

CHttpModule::OnMapPath Method

Represents the method that will handle a MapPath event, which occurs when an operation requests the physical path to be mapped for the current request.

Syntax

virtual REQUEST_NOTIFICATION_STATUS OnMapPath(  
   IN IHttpContext* pHttpContext,  
   IN IMapPathProvider* pProvider  
);  

Parameters

pHttpContext
[IN] A pointer to an IHttpContext interface.

pProvider
[IN] A pointer to an IMapPathProvider interface.

Return Value

A REQUEST_NOTIFICATION_STATUS value.

Remarks

When a request-level module is registered for the RQ_MAP_PATH notification, IIS will call the module's OnMapPath method when an operation requests the physical path to be mapped for the current request.

Note

Request-level modules can register for the MapPath event notification by registering for RQ_MAP_PATH in the module's RegisterModule function.

Example

The following code example demonstrates how to create a request-level HTTP module that registers for the RQ_MAP_PATH event notifications. When an operation requests the physical path to be mapped for the current request, IIS will call the example module's OnMapPath method.

[!code-cpp_MapPath#1]

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

CHttpModule Class