为当前正在执行的线程设置句柄。
语法
HRESULT SetThreadToken (
[in] HANDLE hToken
);
参数
hToken
[in] 要为当前正在执行的线程设置的令牌的句柄。
返回值
| HRESULT | 说明 |
|---|---|
| S_OK | 已成功返回 SetThreadToken。 |
| HOST_E_CLRNOTAVAILABLE | 公共语言运行时 (CLR) 未加载到进程中，或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
| HOST_E_TIMEOUT | 调用超时。 |
| HOST_E_NOT_OWNER | 调用方未持有锁。 |
| HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件，而该事件已被取消。 |
| E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时，进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
注解
IHostSecurityManager::SetThreadToken 的行为类似于具有相同名称的对应 Win32 函数，只不过 Win32 函数允许调用方将句柄传入任意线程，而 IHostSecurityManager::SetThreadToken 仅可以将令牌与当前正在执行的线程相关联。
HANDLE 类型不符合 COM 要求，也就是说，其大小特定于操作系统，并需要自定义封送处理。 因此，此令牌仅在该进程内的 CLR 和主机之间使用。
要求
平台：请参阅系统要求。
标头：MSCorEE.h
库：作为资源包含在 MSCorEE.dll 中
.NET Framework 版本：自 2.0 起可用
