NegotiateStream.ImpersonationLevel Property

Definition

Namespace:

System.Net.Security

Assembly:

System.Net.Security.dll

Source:

NegotiateStream.cs

Gets a value that indicates how the server can use the client's credentials.

public:
 virtual property System::Security::Principal::TokenImpersonationLevel ImpersonationLevel { System::Security::Principal::TokenImpersonationLevel get(); };

public virtual System.Security.Principal.TokenImpersonationLevel ImpersonationLevel { get; }

member this.ImpersonationLevel : System.Security.Principal.TokenImpersonationLevel

Public Overridable ReadOnly Property ImpersonationLevel As TokenImpersonationLevel

Property Value

TokenImpersonationLevel

One of the TokenImpersonationLevel values.

Exceptions

InvalidOperationException

Authentication failed or has not occurred.

Examples

The following code example demonstrates displaying the value of this property.

static void DisplayAuthenticationProperties( NegotiateStream^ stream )
{
   Console::WriteLine( L"IsAuthenticated: {0}", stream->IsAuthenticated );
   Console::WriteLine( L"IsMutuallyAuthenticated: {0}", stream->IsMutuallyAuthenticated );
   Console::WriteLine( L"IsEncrypted: {0}", stream->IsEncrypted );
   Console::WriteLine( L"IsSigned: {0}", stream->IsSigned );
   Console::WriteLine( L"ImpersonationLevel: {0}", stream->ImpersonationLevel );
   Console::WriteLine( L"IsServer: {0}", stream->IsServer );
}

 static void DisplayAuthenticationProperties(NegotiateStream stream)
{
     Console.WriteLine("IsAuthenticated: {0}", stream.IsAuthenticated);
    Console.WriteLine("IsMutuallyAuthenticated: {0}", stream.IsMutuallyAuthenticated);
    Console.WriteLine("IsEncrypted: {0}", stream.IsEncrypted);
    Console.WriteLine("IsSigned: {0}", stream.IsSigned);
    Console.WriteLine("ImpersonationLevel: {0}", stream.ImpersonationLevel);
    Console.WriteLine("IsServer: {0}", stream.IsServer);
}

Remarks

You must successfully authenticate before calling this method. Clients specify the impersonation level when they request authentication by calling one of the AuthenticateAsClient or BeginAuthenticateAsClient methods. If you authenticate without specifying a TokenImpersonationLevel , Identification is used.