Skip to content

iscriptmapinfo-interface.md

Latest commit

 

History

History
72 lines (62 loc) · 4.84 KB

iscriptmapinfo-interface.md

File metadata and controls

72 lines (62 loc) · 4.84 KB
title IScriptMapInfo Interface
ms.date 10/07/2016
description Learn how to retrieve configuration settings for request handlers using methods exposed by the IScriptMapInfo interface.
ms.assetid cc44126f-5ba3-b432-bc2c-aea50024efaa

IScriptMapInfo Interface

Retrieves configuration settings for request handlers.

Syntax

class IScriptMapInfo

Methods

The following table lists the methods exposed by the IScriptMapInfo interface.

Name Description
GetAllowedVerbs Retrieves the list of allowed verbs for a script map.
GetAllowPathInfoForScriptMappings Retrieves a value that indicates whether a script map handler has the allowPathInfo attribute set to true.
GetIsStarScriptMap Retrieves a value that indicates whether a request handler is a wildcard mapping.
GetManagedType Retrieves the managed type for a request handler.
GetModules Retrieves the list of modules for a request handler.
GetName Retrieves the configured name for a request handler.
GetPath Retrieves the path attribute for a request handler.
GetRequiredAccess Retrieves the required-access setting for the script processor.
GetResourceType Retrieves the resource type for a request handler.
GetResponseBufferLimit Retrieves the response buffer limit for the script processor.
GetScriptProcessor Retrieves the script processor for a request handler.

Remarks

The settings for request handlers in [!INCLUDEiisver] are stored in the ApplicationHost.config file, and they contain various attributes that define how request handlers work. For example, the following excerpt from an ApplicationHost.config file shows some of the possible configuration settings for ASP 3.0 or earlier, Internet Server API (ISAPI) DLLs, and static file handling.

<handlers>  
    <add name="ASPClassic"  
        path="*.asp"  
        verb="GET,HEAD,POST"  
        modules="IsapiModule"  
        scriptProcessor="D:\Windows\system32\inetsrv\asp.dll"  
        resourceType="File" />  
    <add name="ISAPI-dll"  
        path="*.dll"  
        verb="*"  
        modules="IsapiModule"  
        resourceType="File"  
        requireAccess="Execute"  
        allowPathInfo="true" />  
    <add name="StaticFile"  
        path="*"  
        verb="*"  
        modules="StaticFileModule,DefaultDocumentModule,DirectoryListingModule"  
        resourceType="Either"  
        requireAccess="Read"/>  
</handlers>

Classes that implement the IScriptMapInfo interface can retrieve the various attributes for request handlers without having to access the ApplicationHost.config file directly.

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 Interfaces