Недокументированные функции NTDLL

17 февраля 2001



NtAdjustGroupsToken (ZwAdjustGroupsToken)

NTSYSAPI 
NTSTATUS
NTAPI

NtAdjustGroupsToken(

IN HANDLE TokenHandle, IN BOOLEAN ResetToDefault, IN PTOKEN_GROUPS TokenGroups, IN ULONG PreviousGroupsLength, OUT PTOKEN_GROUPS PreviousGroups OPTIONAL, OUT PULONG RequiredLength OPTIONAL );




Функция NtAdjustGroupsToken изменяет состояние одной или нескольких групп, доступных для объекта "Токен". См. также описание похожей Win32 API функции AdjustTokenGroups в Win32 SDK.


  • TokenHandle
  •     HANDLE токена, открытый с доступом TOKEN_ADJUST_GROUPS.
  • ResetToDefault
  •     Если установлено, группы сбрасываются в состояние токена по-умолчанию. Остальные параметры в этом случае игнорируются.
  • TokenGroups
  •     Указатель на структуру TOKEN_GROUPS, содержащую группы для изменения.
  • PreviousGroupsLength
  •     Длина буфера PreviousGroups в байтах.
  • PreviousGroups
  •     Дополнительный указатель на буфер TOKEN_GROUPS, получающий информацию об группах перед тем, как начнётся их изменение.
  • RequiredLength
  •     Если задан параметр PreviousGroups и PreviousGroupsLength слишком мал, переменная здесь получает требуемую длину буфера, в байтах.


    Документировал:
    Томаш Новак



    Зависимости:
    Библиотека: ntdll.lib


    См. также:
    NtAdjustPrivilegesToken
    NtCreateToken
    NtOpenProcessToken
    NtOpenThreadToken
    NtQueryInformationToken
    NtSetInformationToken
    TOKEN_GROUPS