System.Security.SecurityContext.SuppressFlowWindowsIdentity Method

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

Syntax

public static System.Threading.AsyncFlowControl SuppressFlowWindowsIdentity ()

Returns

A structure for restoring the flow.

Remarks

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

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

Note:

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 System.Security.Principal.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 about flowing unmanaged impersonation across asynchronous points, see <alwaysFlowImpersonationPolicy> Element.

Requirements

Namespace: System.Security
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 2.0.0.0, 4.0.0.0
Since: .NET 2.0