AuthPersistence

This property specifies authentication persistence across requests on a connection. It is recommended that you set this property by setting the corresponding subflag to TRUE, which will automatically set a binary value for AuthPersistence.

If the AuthPersistSingleRequest is set to TRUE, then authentication persists only for a single request. If AuthPersistSingleRequestIfProxy is set to TRUE, then authentication persists only for a single request if it is a proxy request and the request is not handled by Microsoft Proxy Server. (That is, if Proxy Server and IIS are running on the local computer, and the request is targeted to a remote server.) If AuthPersistSingleRequestAlwaysIfProxy is set to TRUE, then authentication is valid for a single request if the request is by proxy.

Note   Only one sub-flag of AuthPersistence can be TRUE at one time. The subflags are AuthPersistSingleRequest, AuthPersistSingleRequestIfProxy, and AuthPersistSingleRequestAlwaysIfProxy. When one of these three properties is set to TRUE, the other two properties are automatically set to FALSE. The value of AuthPersistence always equals the value of the sub-flag that is set to TRUE.

Data type Long
Default value &H00000080 (or AuthPersistSingleRequestIfProxy=TRUE)
Inheritance Inheritable

This single property contains the following file access permission flags.

AuthPersistSingleRequest AuthPersistSingleRequestAlwaysIfProxy
AuthPersistSingleRequestIfProxy  

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_AUTHORIZATION_PERSISTENCE
User type IIS_MD_UT_FILE
Default bitmask setting MD_AUTH_SINGLEREQUESTIFPROXY

Bitmask Values
Constant Value Description
MD_AUTH_SINGLEREQUEST 0x00000040 Authentication is valid for a single request. IIS will reset the authentication at the end of the request, and force re-authentication on the next request of the session.
MD_AUTH_SINGLEREQUESTIFPROXY 0x00000080 Authentication is valid for a single request. IIS will reset the authentication at the end of the request if the current authenticated request is by proxy, and it is not the special case where IIS is running MSPROXY.
MD_AUTH_SINGLEREQUESTALWAYSIFPROXY 0x00000100 Authentication is valid for a single request. IIS will reset the authentication at the end of the request and force re-authentication on the next request if the current authenticated request is by any type of proxy.