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

Статья
03/05/2024

Функция 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.

Требования

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