SecurityContext.SuppressFlowWindowsIdentity Method

Definition

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

public static System.Threading.AsyncFlowControl SuppressFlowWindowsIdentity ();
[System.Security.SecurityCritical]
public static System.Threading.AsyncFlowControl SuppressFlowWindowsIdentity ();

Returns

A structure for restoring the flow.

Attributes

Exceptions

.NET 5+ (including .NET Core): In all cases.

Remarks

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.

Obs!

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

Applies to

Produkt Versjoner
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9