Функция SetThreadToken (processthreadsapi.h)

  • Статья

Функция SetThreadToken назначает токен олицетворения потоку. Функция также может привести к прекращению потока использования токена олицетворения.

Синтаксис

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

Параметры

[in, optional] Thread

Указатель на дескриптор потока, которому функция назначает токен олицетворения.

Если thread имеет значение NULL, функция назначает маркер олицетворения вызывающему потоку.

[in, optional] Token

Дескриптор маркера олицетворения, назначаемого потоку. Этот дескриптор должен быть открыт с TOKEN_IMPERSONATE правами доступа. Дополнительные сведения см. в разделе Права доступа для объектов Access-Token.

Если параметр Token имеет значение NULL, функция приводит к прекращению использования токена олицетворения потока.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

При использовании функции SetThreadToken для олицетворения необходимо иметь привилегии олицетворения и убедиться в успешном выполнении функции SetThreadToken перед вызовом функции RevertToSelf .

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header processthreadsapi.h (включая Windows.h)
Библиотека Advapi32.lib
DLL Advapi32.dll

См. также раздел

Обзор контроль доступа

Базовые функции контроль доступа

OpenThreadToken