ISAPI20


Name:
ISAPI20

Description:
Load and execute an ISAPI (Internet Server API) extension. You can find more informations about ISAPI filters in the MSDN library.

Options:
Option Default Values Short Description Example(s)
Variable - <Pi3Expression> A variable definition Variable "GATEWAY_INTERFACE=CGI/1.1"
ExtraHeaders Yes Yes|No Indicates if extra headers are considered ExtraHeaders Yes
ExtraHeadersPrefix - <A string> Used as prefix of each extra header ExtraHeadersPrefix "HTTP_"
ExtraHeadersIgnore - <Space delimited Strings> List of unconsidered extra headers ExtraHeadersIgnore "Content-Type Content-Length"
- in the default indicates no default
+ in the default indicates the field is mandatory

Description of Options

Variable
Specifies a server variable expression to be set into the buffer of ISAPI extension calls to GetServerVariable. Could be set multiple times in one configuration object.
ExtraHeaders
This configuration key defines, if extra headers are considered by the processing of this handler.
ExtraHeadersPrefix
This configuration value will be the trailing string of each extra request header.
ExtraHeadersIgnore
The headers in this list are not treated as extra headers.

Phase:
HANDLE

Returns:
PIAPI_COMPLETED, PIAPI_CONTINUE, PIAPI_ERROR, or INT_REDIRECT according to the status returned by the extension.

Note:

Parameters
The Pi3Expressions in the configuration variables may contain besides the standard shortcuts used in Pi3Expressions the following, context specific parameters.
ParameterEvaluates to
%aAll extra headers, as required for header ALL_HTTP
%lContent-Length as DWORD, as required for ISAPI

Example:

	<Object>
		Name ISAPI20
		Class ISAPI20Class
	</Object>

	<Object>
		...
		Handle Condition="&cmp(&dblookup(response,string,ObjectMap,ISAPI),ISAPI)" \
			ISAPI20
		...
	</Object>