На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

SetTokenInformation



The SetTokenInformation function sets various types of information for a specified access token. The information it sets replaces existing information. The calling process must have appropriate access rights to set the information.

BOOL SetTokenInformation(

HANDLE TokenHandle, // handle of access token
TOKEN_INFORMATION_CLASS TokenInformationClass, // type of information to set
LPVOID TokenInformation, // address of information to set
DWORD TokenInformationLength // size of information buffer
);


Parameters

TokenHandle

Identifies the access token for which information is to be set.

TokenInformationClass

Specifies a variable of the TOKEN_INFORMATION_CLASS enumerated type identifying the type of information the function sets. The valid values from TOKEN_INFORMATION_CLASS are TokenOwner, TokenPrimaryGroup, and TokenDefaultDacl. For more information about these values, see the description of the TokenInformation parameter, following.

TokenInformation

Points to a buffer containing the information set in the access token. The structure of this buffer depends on the type of information specified by the TokenInformationClass parameter. The following three values are valid in calls to this function:

Token Information Class Structure Provided
TokenOwner TOKEN_OWNER structure. The TOKEN_ADJUST_DEFAULT access right is needed to set owner information. A valid owner value is a user or group identifier with an attribute allowing assignment as the owner of objects.
TokenPrimaryGroup TOKEN_PRIMARY_GROUP structure. The TOKEN_ADJUST_DEFAULT access right is needed to set primary group information.
TokenDefaultDacl TOKEN_DEFAULT_DACL structure. The TOKEN_ADJUST_DEFAULT access right is needed to set information in the default discretionary access-control list (ACL). The ACL structure provided as a new default discretionary ACL is not validated for correctness or consistency. If the TokenInformation parameter is NULL, the current default discretionary ACL is removed and no replacement is established.


The formats for the structures this function can set are listed in the following Remarks section.

TokenInformationLength

Specifies the length, in bytes, of the buffer pointed to by TokenInformation.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

To set privilege information, an application can call the AdjustTokenPrivileges function. To set a token's groups, an application can call the AdjustTokenGroups function.
Token-type information can be set only when an access token is created.

See Also

AdjustTokenGroups, AdjustTokenPrivileges, GetTokenInformation, OpenProcessToken, OpenThreadToken, TOKEN_DEFAULT_DACL, TOKEN_INFORMATION_CLASS, TOKEN_OWNER, TOKEN_PRIMARY_GROUP


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

SetTokenInformation



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

BOOL SetTokenInformation(

РУЧКА TokenHandle, // ручка признака доступа TOKEN_INFORMATION_CLASS TokenInformationClass, // типа информации, чтобы устанавливать LPVOID TokenInformation, // адрес информации, чтобы устанавливать размер DWORD TokenInformationLength // информационного буфера
);


Параметры

TokenHandle

Идентифицирует признак доступа для которого информация должна быть установлена.

TokenInformationClass

Определяет переменную TOKEN_INFORMATION_CLASS перечислившую тип, опознающий тип информации функция устанавливается. Правильные величины из TOKEN_INFORMATION_CLASS - TokenOwner, TokenPrimaryGroup, и TokenDefaultDacl. Более подробно об этих величинах, смотри описание параметра TokenInformation, следующего за.

TokenInformation

Точки на буфер, содержащие информацию были установлены в признаке доступа. Структура этого буфера зависит от типа информации определенной параметром TokenInformationClass. Следующие три величины будут в силе на вызовах в этой функции:

Предусмотренная Символическая Информационная Структура Класса
СТРУКТУРА TokenOwner TOKEN_OWNER. Право доступа TOKEN_ADJUST_DEFAULT - нужно владельцу набора информации. Правильная величина владельца - пользователь или групповой идентификатор с атрибутом, допускающим назначение как владелец объектов.
СТРУКТУРА TokenPrimaryGroup TOKEN_PRIMARY_GROUP. Право доступа TOKEN_ADJUST_DEFAULT - нужно устанавливать первичную групповую информацию.
СТРУКТУРА TokenDefaultDacl TOKEN_DEFAULT_DACL. Право доступа TOKEN_ADJUST_DEFAULT - нужно устанавливать информацию в по умолчанию дискреционном иметь доступ к-управляющему списку (ACL). Структура ACL предусмотренная как новый по умолчанию дискреционный ACL не подтвержден для правильности или согласованности. Если параметр TokenInformation НЕДЕЙСТВИТЕЛЕН, текущий по умолчанию дискреционный ACL удален и никакая замена не установлена.


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

TokenInformationLength

Определяет длину, в байтах, буфера указанного, чтобы TokenInformation.



Обратные Величины

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

Замечания

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

Смотри Также

AdjustTokenGroups, AdjustTokenPrivileges, GetTokenInformation, OpenProcessToken, OpenThreadToken, TOKEN_DEFAULT_DACL, TOKEN_INFORMATION_CLASS, TOKEN_OWNER, TOKEN_PRIMARY_GROUP


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz