Export (0) Print
Expand All

SecurityContext.SuppressFlowWindowsIdentity Method

Suppresses the flow of the Windows identity portion of the current security context across asynchronous threads.

Namespace: System.Security
Assembly: mscorlib (in mscorlib.dll)

public static AsyncFlowControl SuppressFlowWindowsIdentity ()
public static AsyncFlowControl SuppressFlowWindowsIdentity ()
public static function SuppressFlowWindowsIdentity () : AsyncFlowControl
Not applicable.

Return Value

An AsyncFlowControl structure for restoring the flow.

Use this method to suppress the flow of the Windows identity when the SecurityContext migrates across asynchronous threads.

Use the Undo method on the returned AsyncFlowControl structure to return the SecurityContext object to its previous state.

NoteNote:

The common language runtime (CLR) is aware of impersonation operations performed using only managed code, not of impersonation performed outside of managed code, such as through platform invoke to unmanaged code or through direct calls to Win32 functions. Only managed WindowsIdentity objects can flow across asynchronous points, unless the alwaysFlowImpersonationPolicy element has been set to true (<alwaysFlowImpersonationPolicy enabled="true"/>). Setting the alwaysFlowImpersonationPolicy element to true specifies that the Windows identity always flows across asynchronous points, regardless of how impersonation was performed. For more information on flowing unmanaged impersonation across asynchronous points, see <alwaysFlowImpersonationPolicy> Element.

The following code example shows the use of the SuppressFlowWindowsIdentity method to suppress the flow of the Windows identity. This code example is part of a larger example provided for the SecurityContext class.

AsyncFlowControl aFC2 =
    SecurityContext.SuppressFlowWindowsIdentity();
Console.WriteLine("Has the Windows identity flow been suppressed?"
    + SecurityContext.IsWindowsIdentityFlowSuppressed());

AsyncFlowControl aFC2 = SecurityContext.SuppressFlowWindowsIdentity();
Console.WriteLine("Has the Windows identity flow been suppressed?"
    + SecurityContext.IsWindowsIdentityFlowSuppressed());

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2015 Microsoft