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.
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 |
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 |
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. |