TOKEN_PRIVILEGES 構造体 (winnt.h)

[アーティクル]
03/04/2024

TOKEN_PRIVILEGES構造体には、アクセストークンの一連の特権に関する情報が含まれています。

構文

typedef struct _TOKEN_PRIVILEGES {
  DWORD               PrivilegeCount;
  LUID_AND_ATTRIBUTES Privileges[ANYSIZE_ARRAY];
} TOKEN_PRIVILEGES, *PTOKEN_PRIVILEGES;

メンバー

PrivilegeCount

これは Privileges 配列内のエントリの数に設定する必要があります。

Privileges[ANYSIZE_ARRAY]

LUID_AND_ATTRIBUTES構造体の配列を指定します。各構造体には、特権の LUID と属性が含まれています。 LUID に関連付けられている特権の名前を取得するには、LookupPrivilegeName 関数を呼び出し、LUID のアドレスを lpLuid パラメーターの値として渡します。

大事な 定数 ANYSIZE_ARRAY は、パブリックヘッダー Winnt.h で 1 として定義されます。複数の要素を含むこの配列を作成するには、構造体が追加の要素を考慮するのに十分なメモリを割り当てる必要があります。

特権の属性には、次の値の組み合わせを指定できます。

値	意味
SE_PRIVILEGE_ENABLED	特権が有効になっています。
SE_PRIVILEGE_ENABLED_BY_DEFAULT	特権は既定で有効になっています。
SE_PRIVILEGE_REMOVED	特権を削除するために使用されます。詳細については、「 AdjustTokenPrivileges」を参照してください。
SE_PRIVILEGE_USED_FOR_ACCESS	この特権は、オブジェクトまたはサービスにアクセスするために使用されました。このフラグは、不要な特権を含む可能性があるクライアントアプリケーションによって渡されるセット内の関連する特権を識別するために使用されます。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	winnt.h (Windows.h を含む)