IHostSecurityManager::OpenThreadToken 方法

打开与当前正在执行之线程关联的任意访问令牌。

语法

HRESULT OpenThreadToken (  
    [in]  DWORD    dwDesiredAccess,
    [in]  BOOL     bOpenAsSelf,
    [out] HANDLE   *phThreadToken  
);

dwDesiredAccess
[in] 指定请求的线程令牌访问权限类型之访问值的掩码。这些值在 Win32 OpenThreadToken 函数中定义。请求的访问权限类型要与令牌的自由访问控制列表 (DACL) 一致，以确定要授予或拒绝的访问权限的类型。

bOpenAsSelf
[in] true 指定应使用调用线程之进程的安全性上下文进行访问检查，false 指定应使用调用线程本身的安全性上下文来执行访问检查。如果线程正在模拟客户端，安全性上下文可以是客户端进程的安全性上下文。

phThreadToken
[out] 指向新打开之访问令牌的指针。

HRESULT	说明
S_OK	已成功返回 `OpenThreadToken`。
HOST_E_CLRNOTAVAILABLE	公共语言运行时 (CLR) 未加载到进程中，或 CLR 处于无法运行托管代码或无法成功处理调用的状态。
HOST_E_TIMEOUT	调用超时。
HOST_E_NOT_OWNER	调用方未持有锁。
HOST_E_ABANDONED	阻塞的线程或纤程正在等待某一事件，而该事件已被取消。
E_FAIL	发生未知的灾难性故障。当方法返回 E_FAIL 时，进程中无法再使用 CLR。后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。

IHostSecurityManager::OpenThreadToken 的行为类似于具有相同名称的对应 Win32 函数，只不过 Win32 函数允许调用方将句柄传入任意线程，同时 IHostSecurityManager::OpenThreadToken 仅打开与调用线程关联的令牌。

HANDLE 类型不符合 COM 要求，也就是说，其大小特定于操作系统，并需要自定义封送处理。因此，此令牌仅在该进程内的 CLR 和主机之间使用。

平台：请参阅系统要求。

标头：MSCorEE.h

库：作为资源包含在 MSCorEE.dll 中

.NET Framework 版本：自 2.0 起可用