[This is preliminary documentation and subject to change]

### AuthPersistence

This property contains flags, as listed in the Flags section below, that specify authentication persistence across requests on a connection.

Attribute Name | Attribute Value
Data Type | DWORD
Attributes | INHERIT
Default Value | AuthPersistSingleRequestIfProxy
MetaFlagsEx | CACHE_PROPERTY_MODIFIED
User Type | IIS_MD_UT_FILE
StartingNumber |
EndingNumber | 0
ID | 6031

### Access Locations

This property is accessible at the following locations:

Metabase Path | IIS Admin Object Type
/LM/W3SVC/2 | IIsWebServer
/LM/W3SVC/Info/Templates/Public Web Site | IIsWebServer
/LM/W3SVC/Info/Templates/Secure Web Site | IIsWebServer
/LM/W3SVC | IIsWebService
/LM/W3SVC/1/ROOT | IIsWebVirtualDir
/LM/W3SVC/1/ROOT/_vti_bin | IIsWebVirtualDir
/LM/W3SVC/1/ROOT/IISAdmin | IIsWebVirtualDir
/LM/W3SVC/1/ROOT/IISHelp | IIsWebVirtualDir
/LM/W3SVC/1/ROOT/MSADC | IIsWebVirtualDir
/LM/W3SVC/1/ROOT/Scripts | IIsWebVirtualDir
/LM/W3SVC/2/ROOT | IIsWebVirtualDir
/LM/W3SVC/2/ROOT/IISAdmin | IIsWebVirtualDir

### IIS Admin Base Object Information

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

Metabase identifier | MD_AUTHORIZATION_PERSISTENCE
Data type | DWORD
User type | IIS_MD_UT_FILE

### Flags

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.

Important Only one flag of can be TRUE at one time. When one of these flags is set to TRUE using programmatic methods or the UI, the other two flags are automatically set to FALSE. The value of AuthPersistence always equals the value of the flag that is set to TRUE. When configuring this property by directly editing MetaBase.XML, you must ensure that only one flag is set to true at a time.

Name | Value | Metabase Bitmask Identifier | Description
AuthPersistSingleRequest | 64 | 0x00000040 | MD_AUTH_SINGLEREQUEST | Setting this flag to TRUE specifies that authentication will persist only across single requests on a connection. IIS will reset the authentication at the end of each request, and force re-authentication on the next request of the session.
AuthPersistSingleRequest IfProxy | 128 | 0x00000080 | MD_AUTH_SINGLEREQUEST IFPROXY | Setting this flag to TRUE specifies that authentication will persist only across single requests on a connection if the connection is by proxy. 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.
AuthPersistSingleRequest AlwaysIfProxy | 256 | 0x00000100 | MD_AUTH_SINGLEREQUEST ALWAYSIFPROXY | Setting this flag to TRUE specifies that authentication is valid for a single request if by proxy. 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 proxy of any type.

© 1997-2001 Microsoft Corporation. All rights reserved.