ScriptMaps

This metabase property specifies the file name extensions of applications used for script processor mappings. The List string requires Extension, ScriptProcessor, Flags, IncludedVerbs. Extension is the file name extension (such as .htm), ScriptProcessor is the full path to the DLL, Flags is the integer value corresponding to the requested behavior described below, and IncludedVerbs is a list of the verbs that this ISAPI DLL to handle.

Note   In IIS version 4.0 and earlier, the syntax was to list excluded verbs rather than included verbs. In version 5.0, if no verbs are listed, a value of "all verbs" is assumed. It is recommended that you list the verbs you want your ISAPI filter or extension to handle.

Three possible flags are allowed for each extension mapping, so one of three possible values can be assigned to the Flags attribute.

Possible Flag values Description
1 The script is allowed to run in directories given Script permission. If this value is not set, then the script can only be executed in directories that are flagged for Execute permission.
4 The server attempts to access the PATH_INFO portion of the URL, as a file, before starting the scripting engine. If the file can't be opened, or doesn't exist, an error is returned to the client.
5 Both of the above conditions are TRUE.

For example, to specify the file extension for the ISAPI "Test.dll" with a file extension of ".htm", you might provide the following List (string):

".htm,C:\WINNT40\System32\inetsrv\Test.dll,5,GET, HEAD, POST"
Data type List (string)
Default value Empty list
Inheritance Inheritable

Note IIS allows an "*" in place of the file name extension, which effectively routes all requests though the designated ScriptProcessor. This feature is useful when applying a custom ISAPI extension that will handle requests from all file types.

Access Locations

This property is accessible at the following locations:

Metabase Path Key Type
/LM/W3SVC IIsWebService
/LM/W3SVC/N IIsWebServer
/LM/W3SVC/N/ROOT IIsWebVirtualDir
/LM/W3SVC/N/ROOT/WebVirtualDir IIsWebVirtualDir
/LM/W3SVC/N/ROOT/WebVirtualDir/WebDirectory IIsWebDirectory
/LM/W3SVC/N/ROOT/WebVirtualDir/WebDirectory/WebFile IIsWebFile

IIS Admin Base Object Information

The following tables list additional information required only for code that uses the IIS Admin Base Object.

Metabase identifier MD_SCRIPT_MAPS
Data type MULTISZ_METADATA
Default bitmask value Empty
User type IIS_MD_UT_FILE

Bitmask value
Constant Value Description
MD_SCRIPTMAPFLAG_SCRIPT 0x00000001 Allowed to run if permission is set to Script.
MD_SCRIPTMAPFLAG_CHECK_PATH_INFO 0x00000004 Server checks PATH_INFO.