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: Windows 2000, Windows XP, Windows Server 2003 family

Header: MSCorEE.idl

Library: Included as a resource in MSCorEE.dll

.NET Framework Version: 2.0

See Also

Concepts

ICLRHostProtectionManager Interface

IHostSecurityManager Interface

Hosting Interfaces