Функция ImpersonateSelf (securitybaseapi.h)

Статья
08/25/2023

Функция ImpersonateSelf получает маркер доступа , который олицетворяет контекст безопасности вызывающего процесса. Маркер назначается вызывающему потоку.

Синтаксис

BOOL ImpersonateSelf(
  [in] SECURITY_IMPERSONATION_LEVEL ImpersonationLevel
);

Параметры

[in] ImpersonationLevel

Указывает SECURITY_IMPERSONATION_LEVEL перечислимый тип, предоставляющий уровень олицетворения нового токена.

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

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

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

Функция ImpersonateSelf используется для таких задач, как включение привилегий для одного потока, а не для всего процесса или изменение списка управления доступом по умолчанию (DACL) для одного потока.

Сервер может вызывать функцию RevertToSelf после завершения олицетворения.

Для успешного выполнения этой функции daCL, защищающий маркер процесса, должен предоставить TOKEN_DUPLICATE право на себя.

Требования

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