Export (0) Print
Expand All

IAuthenticationModule.PreAuthenticate Method

Returns an instance of the Authorization class for an authentication request to a server.

Namespace:  System.Net
Assembly:  System (in System.dll)

Authorization PreAuthenticate(
	WebRequest request,
	ICredentials credentials


Type: System.Net.WebRequest

The WebRequest instance associated with the authentication request.

Type: System.Net.ICredentials

The credentials associated with the authentication request.

Return Value

Type: System.Net.Authorization
An Authorization instance containing the authorization message for the request.

When the CanPreAuthenticate property is true, the PreAuthenticate method will return an instance of the Authorization class containing an authentication message.

The following example shows how to use the PreAuthenticate method. For a complete example refer to the AuthenticationManager class.

// The PreAuthenticate method specifies whether the authentication implemented  
// by this class allows pre-authentication.  
// Even if you do not use it, this method must be implemented to obey to the rules  
// of interface implementation. 
// In this case it always returns null.  
public Authorization PreAuthenticate(WebRequest request, ICredentials credentials) 
  return null;

.NET Framework

Supported in: 4.6, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

© 2014 Microsoft