[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 NameAttribute Value
Data TypeDWORD
AttributesINHERIT
Default ValueAuthPersistSingleRequestIfProxy
MetaFlagsExCACHE_PROPERTY_MODIFIED
User TypeIIS_MD_UT_FILE
StartingNumber
EndingNumber0
ID6031

Access Locations

This property is accessible at the following locations:

Metabase PathIIS Admin Object Type
/LM/W3SVC/2IIsWebServer
/LM/W3SVC/Info/Templates/Public Web SiteIIsWebServer
/LM/W3SVC/Info/Templates/Secure Web SiteIIsWebServer
/LM/W3SVCIIsWebService
/LM/W3SVC/1/ROOTIIsWebVirtualDir
/LM/W3SVC/1/ROOT/_vti_binIIsWebVirtualDir
/LM/W3SVC/1/ROOT/IISAdminIIsWebVirtualDir
/LM/W3SVC/1/ROOT/IISHelpIIsWebVirtualDir
/LM/W3SVC/1/ROOT/MSADCIIsWebVirtualDir
/LM/W3SVC/1/ROOT/ScriptsIIsWebVirtualDir
/LM/W3SVC/2/ROOTIIsWebVirtualDir
/LM/W3SVC/2/ROOT/IISAdminIIsWebVirtualDir

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 typeDWORD
User typeIIS_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 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.

NameValueMetabase Bitmask IdentifierDescription
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.