IHostSecurityManager::SetSecurityContext 方法

项目
08/12/2011

设置当前正在执行的线程的安全上下文。

HRESULT SetSecurityContext (
    [in]  EContextType eContextType,
    [out] IHostSecurityContext** ppSecurityContext
);

参数

eContextType
[in] EContextType 值之一，指示公共语言运行时 (CLR) 置于宿主上的上下文类型。
ppSecurityContext
[out] 一个指向新 IHostSecurityContext 对象的地址的指针。

返回值

HRESULT	说明
S_OK	SetSecurityContext 已成功返回。
HOST_E_CLRNOTAVAILABLE	CLR 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。
HOST_E_TIMEOUT	调用超时。
HOST_E_NOT_OWNER	调用方不拥有锁。
HOST_E_ABANDONED	事件在被阻止的线程或纤程正在等待它时被取消。
E_FAIL	发生了未知的灾难性故障。如果某方法返回 E_FAIL，CLR 便无法再在进程中使用。对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。

备注

CLR 在一些方案中将调用 SetSecurityContext。在执行类和模块构造函数和终结器之前，CLR 调用 SetSecurityContext 以防止宿主执行失败。在执行构造函数或终结器之后，将通过再次调用 SetSecurityContext 将安全上下文重置为其原始状态。 I/O 完成的模式也与此类似。如果宿主实现 IHostIoCompletionManager，则 CLR 将在宿主调用 ICLRIoCompletionManager::OnComplete 之后调用 SetSecurityContext。

在辅助线程中的异步点，根据是宿主还是 CLR 实现的线程池，CLR 将在 ThreadPool.QueueUserWorkItem 内或在 IHostThreadPoolManager::QueueUserWorkItem 内调用 SetSecurityContext。