На главную

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 | Скачать Вниз

AdjustTokenGroups



The AdjustTokenGroups function adjusts groups in the specified access token. TOKEN_ADJUST_GROUPS access is required to enable or disable groups in an access token.

BOOL AdjustTokenGroups(

HANDLE TokenHandle, // handle to token that contains groups
BOOL ResetToDefault, // flag for default settings
PTOKEN_GROUPS NewState, // address of address of new group information
DWORD BufferLength, // size of buffer for previous information
PTOKEN_GROUPS PreviousState, // address of previous group information
PDWORD ReturnLength // address of required buffer size
);


Parameters

TokenHandle

Identifies the access token containing the groups to be modified.

ResetToDefault

Specifies whether the groups are to be set to their default enabled and disabled states. If this value is TRUE, the groups are set to their default states and the NewState parameter is ignored. If this value is FALSE, the groups are set according to the information pointed to by the NewState parameter.

NewState

Points to a TOKEN_GROUPS structure containing the groups whose states are to be set. If the ResetToDefault parameter is FALSE, the function sets each of the groups to the value of that group's SE_GROUP_ENABLED flag in the TOKEN_GROUPS structure. If ResetToDefault is TRUE, this parameter is ignored.

BufferLength

Specifies the size, in bytes, of the buffer pointed to by the PreviousState parameter. This parameter can be NULL if the PreviousState parameter is NULL.

PreviousState

Points to a buffer receiving a TOKEN_GROUPS structure containing the previous state of any groups the function modifies. The token must be open for TOKEN_QUERY access to use this parameter. This parameter can be NULL.
If a buffer is specified but it does not contain enough space to receive the complete list of modified groups, no group states are changed and the function fails. In this case, the function sets the variable pointed to by the ReturnLength parameter to the number of bytes required to hold the complete list of modified groups.

ReturnLength

Points to a variable set by the function that contains the actual number of bytes needed for the buffer pointed to by the PreviousState parameter. This parameter can be NULL and is ignored if PreviousState is NULL.



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

The information retrieved in the PreviousState parameter is formatted as a TOKEN_GROUPS structure. This means a pointer to the buffer can be passed as the NewState parameter in a subsequent call to the AdjustTokenGroups function, restoring the original state of the groups.
The NewState parameter can list groups to be changed that are not present in the access token. This does not affect the successful modification of the groups in the token.

Mandatory groups cannot be disabled. They are identified by the SE_GROUP_MANDATORY flag in the TOKEN_GROUPS structure. If an attempt is made to disable any mandatory groups, AdjustTokenGroups fails and leaves the state of all groups unchanged.

See Also

AdjustTokenPrivileges, GetTokenInformation, OpenProcessToken, OpenThreadToken, SetTokenInformation, TOKEN_GROUPS


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

AdjustTokenGroups



Функция AdjustTokenGroups регулирует группы в определенном признаке доступа. доступ TOKEN_ADJUST_GROUPS требуется приспосабливается или выводит из строя группы в признак доступа.

BOOL AdjustTokenGroups(

РУЧКА TokenHandle, // оперируется в признак, который содержит группы BOOL ResetToDefault, // флаг для по умолчанию установочных параметров PTOKEN_GROUPS NewState, // адреса адреса новой групповой информации DWORD BufferLength, // размера буфера для предшествующей информации PTOKEN_GROUPS PreviousState, // адреса предшествующего группового адреса информации PDWORD ReturnLength // необходимого буферного размера
);


Параметры

TokenHandle

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

ResetToDefault

Определяет должны группы быть установлены в их по умолчанию разблокированные и выведенные из строя состояния. Если эта величина является ИСТИНОЙ, группы установлены в их по умолчанию состояния и параметр NewState проигнорирован. Если эта величина является ЛОЖЬЮ, группы установлены согласно информации указанной, чтобы параметром NewState.

NewState

Точки на структуру TOKEN_GROUPS, содержащие группы, чьи состояния должны быть установлены. Если параметр ResetToDefault является ЛОЖЬЮ, функция устанавливает каждые группы в величину этого группового флага SE_GROUP_ENABLED в структуре TOKEN_GROUPS. Если ResetToDefault - ИСТИНА, этот параметр проигнорирован.

BufferLength

Определяет размер, в байтах, буфера указанного, чтобы параметром PreviousState. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если параметр PreviousState НЕДЕЙСТВИТЕЛЕН.

PreviousState

Точки на буфер, получающие структурное содержание TOKEN_GROUPS предшествующее состояние любых групп функция модифицируется. Признак должен быть открытым для доступа TOKEN_QUERY, чтобы использовать этот параметр. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН.
Если буфер определен но он не содержит достаточно пространства, чтобы получать полный список модифицировать групп, никакие групповые состояния не измениться и функция терпит неудачу. В этом случае, функция устанавливает переменную указанную, чтобы параметром ReturnLength в количество байтов требовавшихся, чтобы держать полный список модифицировать групп.

ReturnLength

Точки на переменную были установлены функцией, которая содержит фактическое количество байтов необходимое для буфера указанного, чтобы параметром PreviousState. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН и проигнорирован если PreviousState НЕДЕЙСТВИТЕЛЕН.



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

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

Замечания

Информация извлеченная в параметр PreviousState отформатирована как структура TOKEN_GROUPS. Это означает указатель в буфер может быть пройдено как параметр NewState в последующий вызов на функция AdjustTokenGroups, восстанавливающий оригинальное состояние групп.
Параметр NewState может указать группы, которые нужно изменять, что не присутствовать в признаке доступа. Это не влияет на успешную модификацию групп в признаке.

Обязательные группы не могут быть выведены из строя. Они называются флагом SE_GROUP_MANDATORY в структуре TOKEN_GROUPS. Если попытка сделана, чтобы выводить из строя любые обязательные группы, AdjustTokenGroups терпит неудачу и оставляет состояние всех групп неизменных.

Смотри Также

AdjustTokenPrivileges, GetTokenInformation, OpenProcessToken, OpenThreadToken, SetTokenInformation, TOKEN_GROUPS


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