AdjustTokenGroups

指定したアクセストークンに既に存在するグループを有効化または無効化する。アクセストークン内のグループを有効化または無効化するには TOKEN_ADJUST_GROUPS へのアクセスが必要である。

AdjustTokenGroups TokenHandle, ResetToDefault, NewState, BufferLength, PreviousState, ReturnLength

TokenHandle : [intptr] 有効化または無効化するグループを含むアクセストークンへのハンドル。ハンドルはトークンに対する TOKEN_ADJUST_GROUPS アクセス権を持っている必要がある。PreviousState パラメータが NULL でない場合、ハンドルは TOKEN_QUERY アクセス権も持っている必要がある。
ResetToDefault : [int] グループを既定の有効/無効状態に設定するかどうかを示すブール値。この値が TRUE の場合、グループは既定状態に設定され NewState パラメータは無視される。FALSE の場合、グループは NewState パラメータが指す情報に従って設定される。
NewState : [var] 有効化または無効化するグループを含む TOKEN_GROUPS 構造体へのポインタ。ResetToDefault パラメータが FALSE の場合、関数は TOKEN_GROUPS 構造体内の各グループの SE_GROUP_ENABLED 属性の値に従って各グループを設定する。ResetToDefault が TRUE の場合、このパラメータは無視される。
BufferLength : [int] PreviousState パラメータが指すバッファのサイズ（バイト単位）。PreviousState パラメータが NULL の場合、このパラメータは 0 にできる。
PreviousState : [var] 関数が変更するグループの以前の状態を格納する TOKEN_GROUPS 構造体を受け取るバッファへのポインタ。すなわち、本関数によって変更されたグループがあれば、そのグループと以前の状態が PreviousState で参照される TOKEN_GROUPS 構造体に格納される。TOKEN_GROUPS の GroupCount メンバが 0 の場合、本関数によって変更されたグループはない。このパラメータは NULL にできる。
ReturnLength : [var] PreviousState パラメータが指すバッファに必要な実際のバイト数を受け取る変数へのポインタ。このパラメータは NULL にでき、PreviousState が NULL の場合は無視される。

(プラグイン / モジュール : advapi32.dll)

解説

指定したアクセストークンに既に存在するグループを有効化または無効化する。アクセストークン内のグループを有効化または無効化するには
TOKEN_ADJUST_GROUPS へのアクセスが必要である。

[戻り値]
関数が成功した場合、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼び出す。

[備考]
PreviousState パラメータで取得される情報は TOKEN_GROUPS
構造体の形式となる。つまり、バッファへのポインタを後続の AdjustTokenGroups 関数呼び出しの NewState
パラメータとして渡すことで、グループの元の状態を復元できる。NewState
パラメータには、アクセストークンに存在しない変更対象グループを列挙してもかまわない。これはトークン内のグループの変更成功には影響しない。AdjustTokenGroups
関数は、TOKEN_GROUPS 構造体内の SE_GROUP_MANDATORY 属性を持つグループを無効化できない。その場合は
CreateRestrictedToken を使用する。SE_GROUP_USE_FOR_DENY_ONLY
属性を持つグループは有効化できない。

情報