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