Skip to content

imaphandlerprovider-setscriptmap-method.md

Latest commit

 

History

History
47 lines (35 loc) · 3.34 KB

imaphandlerprovider-setscriptmap-method.md

File metadata and controls

47 lines (35 loc) · 3.34 KB
title IMapHandlerProvider::SetScriptMap Method
description Describes the IMapHandlerProvider::SetScriptMap method and details its syntax, parameters, return value, remarks, code example, and requirements.
ms.date 10/07/2016
ms.assetid f1fde288-284d-7035-201c-fb3c508b0213

IMapHandlerProvider::SetScriptMap Method

Specifies which IScriptMapInfo interface to use for the current context.

Syntax

virtual VOID SetScriptMap(  
   IScriptMapInfo* pScriptMap  
) = 0;

Parameters

pScriptMap
A pointer to an IScriptMapInfo interface.

Return Value

VOID.

Remarks

The SetScriptMap method allows an HTTP module to specify which IScriptMapInfo interface to use when IIS processes a request within the current context. For example, you can create a custom IScriptMapInfo interface and specify that IIS use that interface to process the current request if a Web client requests a specific resource on your Web site.

Example

The following example code demonstrates how to create an HTTP module that creates a custom IScriptMapInfo interface. The module uses the SetScriptMap method to specify that IIS use the custom interface to process the current request and then exits.

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

IMapHandlerProvider Interface