setThreadToken 函数 (processthreadsapi.h)

SetThreadToken 函数将模拟令牌分配给线程。 函数还可能导致线程停止使用模拟令牌。

语法

BOOL SetThreadToken(
  [in, optional] PHANDLE Thread,
  [in, optional] HANDLE  Token
);

参数

[in, optional] Thread

指向函数向其分配模拟令牌的线程句柄的指针。

如果 ThreadNULL,则该函数会将模拟令牌分配给调用线程。

[in, optional] Token

要分配给线程的模拟令牌的句柄。 此句柄必须已使用 TOKEN_IMPERSONATE 访问权限打开。 有关详细信息,请参阅 Access-Token 对象的访问权限

如果 TokenNULL,则该函数会导致线程停止使用模拟令牌。

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。

注解

使用 SetThreadToken 函数进行模拟时,必须具有模拟权限,并确保 SetThreadToken 函数在调用 RevertToSelf 函数之前成功。

要求

要求
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 processthreadsapi.h (包括 Windows.h)
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

访问控制概述

基本访问控制函数

OpenThreadToken