IHostSecurityContext Interface

Allows the common language runtime (CLR) to maintain security context information implemented by the host.

interface IHostSecurityContext : IUnknown {
    HRESULT Capture (
        [out] IHostSecurityContext** ppClonedContext
    )
};

Methods

Method

Description

IHostSecurityContext::Capture Method

Gets a clone of the IHostSecurityContext instance returned from a call to IHostSecurityManager::GetSecurityContext.

Remarks

A host can control all code access to thread tokens by both the CLR and user code. It can also ensure that complete security context information is passed across asynchronous operations or code points with restricted code access. IHostSecurityContext encapsulates this security context information, which is opaque to the runtime. The runtime captures this information using Capture, and moves it across thread pool worker item dispatch, finalizer execution, and module and class constructors.

Requirements

Platforms: See .NET Framework System Requirements.

Header: MSCorEE.idl

Library: Included as a resource in MSCorEE.dll

.NET Framework Versions: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

See Also

Reference

ICLRHostProtectionManager Interface

IHostSecurityManager Interface

Other Resources

Hosting Interfaces