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