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 物件產生關聯的屬性。

rTokenGroups
TOKEN_GROUPS 結構。

備註

這些方法會將一或多個 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 結構的指標 。

另請參閱

安全性範例
CSid 類別
類別概觀
安全性全域函式