|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
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
|
|
|
|
| |