CHttpModule::OnMapPath Method

CHttpModule::OnMapPath Method

IIS 7.0
 

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.

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

pHttpContext

[IN] A pointer to an IHttpContext interface.

pProvider

[IN] A pointer to an IMapPathProvider interface.

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.

System_CAPS_noteNote

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.

Requirements

Type

Description

Client

  • IIS 7.0 on Windows Vista

  • IIS 7.5 on Windows 7

  • IIS 8.0 on Windows 8

  • IIS 10.0 on Windows 10

Server

  • IIS 7.0 on Windows Server 2008

  • 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 Technical Preview

Product

  • IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0

  • IIS Express 7.5, IIS Express 8.0, IIS Express 10.0

Header

Httpserv.h

Show:
© 2016 Microsoft