WebClientProtocol.PreAuthenticate Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets whether pre-authentication is enabled.
public:
property bool PreAuthenticate { bool get(); void set(bool value); };
public bool PreAuthenticate { get; set; }
member this.PreAuthenticate : bool with get, set
Public Property PreAuthenticate As Boolean
Property Value
true
to pre-authenticate the request; otherwise, false
. The default is false
.
Remarks
When a client requests a resource without using credentials, the server challenges the request and indicates what authentication schemes it supports. The client chooses an authentication scheme and sends the appropriate WWW-authenticate
header to the server. When PreAuthenticate is true
, the WWW-authenticate
header is sent with all subsequent requests.
When PreAuthenticate is false
, a request is made to the XML Web service method without initially attempting to authenticate the user. If the XML Web service allows anonymous access, then the XML Web service method is executed. If anonymous access is disallowed, a 401 HTTP return code is sent back to the client. In response, the WebClientProtocol class returns authentication credentials to the Web server. If the client is authenticated and subsequently authorized to access the XML Web service, the XML Web service method is executed; otherwise the client is denied access.