Поделиться через


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

Функция SetTokenInformation задает различные типы сведений для указанного маркера доступа. Сведения, устанавливаемые этой функцией, заменяют существующие сведения. Вызывающий процесс должен иметь соответствующие права доступа для задания сведений.

Синтаксис

BOOL SetTokenInformation(
  [in] HANDLE                  TokenHandle,
  [in] TOKEN_INFORMATION_CLASS TokenInformationClass,
  [in] LPVOID                  TokenInformation,
  [in] DWORD                   TokenInformationLength
);

Параметры

[in] TokenHandle

Дескриптор маркера доступа, для которого необходимо задать сведения.

[in] TokenInformationClass

Значение из перечисленного типа TOKEN_INFORMATION_CLASS , определяющее тип сведений, которые задает функция. Допустимые значения из TOKEN_INFORMATION_CLASS описаны в параметре TokenInformation .

[in] TokenInformation

Указатель на буфер, содержащий сведения, заданные в маркере доступа. Структура этого буфера зависит от типа информации, указанной параметром TokenInformationClass .

[in] TokenInformationLength

Указывает длину (в байтах) буфера, на который указывает TokenInformation.

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

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

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

Комментарии

Чтобы задать сведения о привилегиях, приложение может вызвать функцию AdjustTokenPrivileges . Чтобы задать группы маркера, приложение может вызвать функцию AdjustTokenGroups .

Сведения о типе маркера можно задать только при создании маркера доступа.

Требования

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

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

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

AdjustTokenGroups

AdjustTokenPrivileges

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

GetTokenInformation

OpenProcessToken

OpenThreadToken

TOKEN_DEFAULT_DACL

TOKEN_INFORMATION_CLASS

TOKEN_OWNER

TOKEN_PRIMARY_GROUP