ClientCredentials.Windows 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 an object used to control the Windows credential that the client uses to authenticate itself to the service.
public:
property System::ServiceModel::Security::WindowsClientCredential ^ Windows { System::ServiceModel::Security::WindowsClientCredential ^ get(); };public System.ServiceModel.Security.WindowsClientCredential Windows { get; }member this.Windows : System.ServiceModel.Security.WindowsClientCredentialPublic ReadOnly Property Windows As WindowsClientCredentialProperty Value
A WindowsClientCredential that represents the current Windows credential.
Examples
The following code shows how to use the object returned by this property to configure the impersonation level.
// Create a client object with the given client endpoint configuration.
CalculatorClient client = new CalculatorClient();
try
{
client.ClientCredentials.Windows.AllowedImpersonationLevel
= TokenImpersonationLevel.Impersonation;
}
catch (TimeoutException timeProblem)
{
Console.WriteLine("The service operation timed out. " + timeProblem.Message);
Console.ReadLine();
client.Abort();
}
catch (CommunicationException commProblem)
{
Console.WriteLine("There was a communication problem. " + commProblem.Message + commProblem.StackTrace);
Console.ReadLine();
client.Abort();
}
' Create a client object with the given client endpoint configuration.
Dim client As New CalculatorClient()
Try
client.ClientCredentials.Windows.AllowedImpersonationLevel = TokenImpersonationLevel.Impersonation
Catch timeProblem As TimeoutException
Console.WriteLine("The service operation timed out. " & timeProblem.Message)
Console.ReadLine()
client.Abort()
Catch commProblem As CommunicationException
Console.WriteLine("There was a communication problem. " & commProblem.Message + commProblem.StackTrace)
Console.ReadLine()
client.Abort()
End Try
Remarks
You can use the object returned by this property to configure the Windows credential by calling its members, such as AllowNtlm and AllowedImpersonationLevel.
These settings control the Windows credential used during SPNEGO negotiation at either the message or transport level or the properties of Kerberos tokens used for authentication at the message level.
