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

© 1997-2001 Microsoft Corporation. All rights reserved.