This documentation is archived and is not being maintained.

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, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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