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 參數的值。

重要公用標頭 Winnt.h 中的常數 ANYSIZE_ARRAY 定義為 1。若要建立具有多個元素的陣列，您必須配置足夠的記憶體，結構才能考慮其他元素。

許可權的屬性可以是下列值的組合。

值	意義
SE_PRIVILEGE_ENABLED	已啟用許可權。
SE_PRIVILEGE_ENABLED_BY_DEFAULT	默認會啟用許可權。
SE_PRIVILEGE_REMOVED	用來移除許可權。如需詳細資訊，請參閱 AdjustTokenPrivileges。
SE_PRIVILEGE_USED_FOR_ACCESS	許可權是用來取得物件或服務的存取權。此旗標可用來識別用戶端應用程式所傳遞之集合中可能包含不必要的許可權的相關許可權。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	winnt.h (包括 Windows.h)