CTokenGroups 類別
這個類別是 結構的 TOKEN_GROUPS 包裝函式。
重要
這個類別及其成員不能用於在 Windows 執行階段 中執行的應用程式。
語法
class CTokenGroups
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
| CTokenGroups：：CTokenGroups | 建構函式。 |
| CTokenGroups：：~CTokenGroups | 解構函式。 |
公用方法
| 名稱 | 描述 |
|---|---|
| CTokenGroups：：Add | CSid將或現有的 TOKEN_GROUPS 結構加入CTokenGroups至物件。 |
| CTokenGroups：:D elete | CSid從 CTokenGroups 物件中刪除 及其相關聯的屬性。 |
| CTokenGroups：:D eleteAll | 從物件中刪除所有 CSid 物件及其相關聯的屬性 CTokenGroups 。 |
| CTokenGroups：：GetCount | 傳回物件中包含的CTokenGroups對象和相關聯屬性數目CSid。 |
| CTokenGroups：：GetLength | 傳回物件的大小 CTokenGroups 。 |
| CTokenGroups：：GetPTOKEN_GROUPS | 擷取 結構的 TOKEN_GROUPS 指標。 |
| CTokenGroups：：GetSidsAndAttributes | CSid擷取屬於 CTokenGroups 對象的物件和屬性。 |
| CTokenGroups：：LookupSid | 擷取與 CSid 對象相關聯的屬性。 |
公用運算子
| 名稱 | 描述 |
|---|---|
| CTokenGroups：：operator const TOKEN_GROUPS * | 將 CTokenGroups 物件轉換成 結構的 TOKEN_GROUPS 指標。 |
| CTokenGroups：：operator = | 指派運算子。 |
備註
存取令牌是物件，描述進程或線程的安全性內容，並配置給登入 Windows 系統的每個使用者。
類別CTokenGroups是TOKEN_GROUPS結構的包裝函式，其中包含存取令牌中群組安全性標識碼 （SID） 的相關信息。
如需 Windows 中存取控制模型的簡介，請參閱 Windows SDK 中的 存取控制。
需求
標頭： atlsecurity.h
CTokenGroups：：Add
CSid將或現有的 TOKEN_GROUPS 結構加入CTokenGroups至物件。
void Add(const CSid& rSid, DWORD dwAttributes) throw(... );
void Add(const TOKEN_GROUPS& rTokenGroups) throw(...);
參數
rSid
CSid 物件。
dwAttributes
要與 CSid 對象產生關聯的屬性。
備註
這些方法會將一或多個 CSid 物件及其相關聯的屬性新增至 CTokenGroups 物件。
CTokenGroups：：CTokenGroups
建構函式。
CTokenGroups() throw();
CTokenGroups(const CTokenGroups& rhs) throw(... );
CTokenGroups(const TOKEN_GROUPS& rhs) throw(...);
參數
rhs
要CTokenGroups用來建構CTokenGroups物件的物件或TOKEN_GROUPS結構。
備註
CTokenGroups您可以使用 結構或先前定義的 CTokenGroups 對象，選擇性地建立 TOKEN_GROUPS 物件。
CTokenGroups：：~CTokenGroups
解構函式。
virtual ~CTokenGroups() throw();
備註
解構函式會釋放所有已配置的資源。
CTokenGroups：:D elete
CSid從 CTokenGroups 物件中刪除 及其相關聯的屬性。
bool Delete(const CSid& rSid) throw();
參數
rSid
應該移除安全性識別碼 （SID） 和屬性的 CSid 物件。
傳回值
如果 CSid 已移除 ，則傳回 true，否則傳回 false。
CTokenGroups：:D eleteAll
從物件中刪除所有 CSid 物件及其相關聯的屬性 CTokenGroups 。
void DeleteAll() throw();
CTokenGroups：：GetCount
傳回 中包含的CTokenGroups物件數目CSid。
UINT GetCount() const throw();
傳回值
傳回物件中包含的 CTokenGroups CSid 物件數目及其相關聯的屬性。
CTokenGroups：：GetLength
傳回物件的大小 CTokenGroup 。
UINT GetLength() const throw();
備註
傳回物件的大小總計 CTokenGroup ，以位元組為單位。
CTokenGroups：：GetPTOKEN_GROUPS
擷取 結構的 TOKEN_GROUPS 指標。
const TOKEN_GROUPS* GetPTOKEN_GROUPS() const throw(...);
傳回值
擷取屬於CTokenGroups存取令牌物件的TOKEN_GROUPS結構的指標。
CTokenGroups：：GetSidsAndAttributes
CSid擷取 物件，並（選擇性地）擷取屬於 CTokenGroups 對象的屬性。
void GetSidsAndAttributes(
CSid::CSidArray* pSids,
CAtlArray<DWORD>* pAttributes = NULL) const throw(...);
參數
pSids
CSid 對象的陣列指標。
pAttributes
DWORD 陣列的指標。 如果省略此參數或 NULL，則不會擷取屬性。
備註
這個方法會列舉 物件中包含的CTokenGroups所有CSid物件，並將其和屬性旗標放入陣列物件中。
CTokenGroups：：LookupSid
擷取與 CSid 對象相關聯的屬性。
bool LookupSid(
const CSid& rSid,
DWORD* pdwAttributes = NULL) const throw();
參數
rSid
CSid 物件。
pdwAttributes
將接受 CSid 物件屬性的 DWORD 指標。 如果省略或 NULL，將不會擷取屬性。
傳回值
如果 CSid 找到 ，則傳回 true，否則傳回 false。
備註
將 pdwAttributes 設定為 NULL，可讓您確認 是否存在CSid而不存取 屬性。 請注意，這個方法不應該用來檢查訪問許可權。 應用程式應該改用 CAccessToken：：CheckTokenMembership 方法。
CTokenGroups：：operator =
指派運算子。
CTokenGroups& operator= (const TOKEN_GROUPS& rhs) throw(...);
CTokenGroups& operator= (const CTokenGroups& rhs) throw(...);
參數
rhs
要CTokenGroups指派給CTokenGroups物件的物件或TOKEN_GROUPS結構。
傳回值
傳回更新 CTokenGroups 的物件。
CTokenGroups：：operator const TOKEN_GROUPS *
將值轉換成 結構的 TOKEN_GROUPS 指標。
operator const TOKEN_GROUPS *() const throw(...);
備註
將值轉換成TOKEN_GROUPS結構的指標。