SecurityManager.CurrentThreadRequiresSecurityContextCapture Method

Definition

Namespace:

System.Security

Assembly:

System.Security.Permissions.dll

Package:

System.Security.Permissions v8.0.0

Source:

SecurityManager.cs

Determines whether the current thread requires a security context capture if its security state has to be re-created at a later point in time.

public:
 static bool CurrentThreadRequiresSecurityContextCapture();

public static bool CurrentThreadRequiresSecurityContextCapture ();

static member CurrentThreadRequiresSecurityContextCapture : unit -> bool

Public Shared Function CurrentThreadRequiresSecurityContextCapture () As Boolean

Returns

Boolean

false if the stack contains no partially trusted application domains, no partially trusted assemblies, and no currently active PermitOnly() or Deny() modifiers; true if the common language runtime cannot guarantee that the stack contains none of these.

Remarks

You can use the CurrentThreadRequiresSecurityContextCapture method before you cache sensitive data that is obtained after successful security demands.

If the Assert method has been called higher on the stack, the data should not be cached without capturing the corresponding security context. Otherwise, sensitive data that is obtained under an Assert may become available to code that is no longer be running with that Assert in place.

Important

The return value is reliable only when it is false, which means that the thread is guaranteed not to require a security context capture. The method may return true when a security context capture is not necessary, to avoid security vulnerabilities.

CurrentThreadRequiresSecurityContextCapture is security-critical because its main use is to avoid unnecessary security context captures, which indicates that the code using it is security-sensitive and must be audited.