IHostSecurityManager::GetSecurityContext 方法
从主机获取请求的 IHostSecurityContext。
语法
HRESULT GetSecurityContext (
[in] EContextType eContextType,
[out] IHostSecurityContext** ppSecurityContext
);
参数
eContextType
[in] EContextType 值之一,指示要返回的安全上下文的类型。
ppSecurityContext
[out] 指向 eContextType
的 IHostSecurityContext
的接口指针的地址。
返回值
HRESULT | 说明 |
---|---|
S_OK | 已成功返回 GetSecurityContext 。 |
HOST_E_CLRNOTAVAILABLE | 公共语言运行时 (CLR) 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
HOST_E_TIMEOUT | 调用超时。 |
HOST_E_NOT_OWNER | 调用方未持有锁。 |
HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
注解
主机可以通过 CLR 和用户代码控制对线程令牌的所有代码访问。 它还可以确保完整的安全上下文信息在异步操作或代码访问受限的代码点之间传递。 IHostSecurityContext
封装此安全上下文信息,这对于 CLR 是不透明的。 CLR 捕获此信息,并将其在线程池工作项调度、终结器执行以及模块和类构造之间移动。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用