CTokenGroups Sınıfı

Bu sınıf, yapısı için TOKEN_GROUPS bir sarmalayıcıdır.

Önemli

Bu sınıf ve üyeleri Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz.

Sözdizimi

class CTokenGroups

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CTokenGroups::CTokenGroups	Oluşturucu.
CTokenGroups::~CTokenGroups	Yok edici.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CTokenGroups::Add	Nesneye veya var olan TOKEN_GROUPS bir CSid yapı eklerCTokenGroups.
CTokenGroups::D elete	nesnesinden CTokenGroups bir CSid ve ilişkili özniteliklerini siler.
CTokenGroups::D eleteAll	Nesneden CTokenGroups tüm CSid nesneleri ve ilişkili özniteliklerini siler.
CTokenGroups::GetCount	Nesnede bulunan CTokenGroups nesne sayısını CSid ve ilişkili öznitelikleri döndürür.
CTokenGroups::GetLength	Nesnenin CTokenGroups boyutunu döndürür.
CTokenGroups::GetPTOKEN_GROUPS	Yapıya TOKEN_GROUPS yönelik bir işaretçi alır.
CTokenGroups::GetSidsAndAttributes	Nesneye CSid ait CTokenGroups nesneleri ve öznitelikleri alır.
CTokenGroups::LookupSid	Bir CSid nesneyle ilişkili öznitelikleri alır.

Ortak İşleçler

Veri Akışı Adı	Açıklama
CTokenGroups::operator const TOKEN_GROUPS *	CTokenGroups Nesneyi yapıya yönelik bir işaretçiye dönüştürürTOKEN_GROUPS.
CTokenGroups::operator =	Atama işleci.

Açıklamalar

Erişim belirteci, bir işlemin veya iş parçacığının güvenlik bağlamını açıklayan ve bir Windows sisteminde oturum açmış her kullanıcıya ayrılan bir nesnedir.

CTokenGroups sınıfı, bir erişim belirtecindeki grup güvenlik tanımlayıcıları (SID' ler) hakkında bilgi içeren TOKEN_GROUPS yapısı için bir sarmalayıcıdır.

Windows'ta erişim denetimi modeline giriş için bkz . Windows SDK'sında Erişim Denetimi .

Gereksinimler

Üst bilgi: atlsecurity.h

CTokenGroups::Add

Nesneye veya var olan TOKEN_GROUPS bir CSid yapı eklerCTokenGroups.

void Add(const CSid& rSid, DWORD dwAttributes) throw(... );
void Add(const TOKEN_GROUPS& rTokenGroups) throw(...);

Parametreler

rSid
CSid nesnesi.

dwAttributes
Nesnesiyle CSid ilişkilendirilecek öznitelikler.

rTokenGroups
TOKEN_GROUPS bir yapı.

Açıklamalar

Bu yöntemler nesneye CTokenGroups bir veya daha fazla CSid nesne ve ilişkili öznitelikleri ekler.

CTokenGroups::CTokenGroups

Oluşturucu.

CTokenGroups() throw();
CTokenGroups(const CTokenGroups& rhs) throw(... );
CTokenGroups(const TOKEN_GROUPS& rhs) throw(...);

Parametreler

Rhs
Nesnenin CTokenGroups oluşturulduğu CTokenGroups nesne veya TOKEN_GROUPS yapısı.

Açıklamalar

CTokenGroups Nesnesi isteğe bağlı olarak bir TOKEN_GROUPS yapı veya önceden tanımlanmış CTokenGroups bir nesne kullanılarak oluşturulabilir.

CTokenGroups::~CTokenGroups

Yok edici.

virtual ~CTokenGroups() throw();

Açıklamalar

Yıkıcı, ayrılan tüm kaynakları boşaltıyor.

CTokenGroups::D elete

nesnesinden CTokenGroups bir CSid ve ilişkili özniteliklerini siler.

bool Delete(const CSid& rSid) throw();

Parametreler

rSid
Güvenlik tanımlayıcısı (SID) ve özniteliklerinin kaldırılması gereken CSid nesnesi.

Dönüş Değeri

kaldırılırsa CSid true, aksi takdirde false döndürür.

CTokenGroups::D eleteAll

Nesneden CTokenGroups tüm CSid nesneleri ve ilişkili özniteliklerini siler.

void DeleteAll() throw();

CTokenGroups::GetCount

içinde CTokenGroupsbulunan nesne sayısını CSid döndürür.

UINT GetCount() const throw();

Dönüş Değeri

CSid nesnelerinin sayısını ve nesnede CTokenGroups bulunan ilişkili özniteliklerini döndürür.

CTokenGroups::GetLength

Nesnenin CTokenGroup boyutunu döndürür.

UINT GetLength() const throw();

Açıklamalar

Nesnenin CTokenGroup bayt cinsinden toplam boyutunu döndürür.

CTokenGroups::GetPTOKEN_GROUPS

Yapıya TOKEN_GROUPS yönelik bir işaretçi alır.

const TOKEN_GROUPS* GetPTOKEN_GROUPS() const throw(...);

Dönüş Değeri

Erişim belirteci nesnesine ait TOKEN_GROUPS yapısının işaretçisini CTokenGroups alır.

CTokenGroups::GetSidsAndAttributes

CSid Nesneleri ve (isteğe bağlı olarak) nesneye CTokenGroups ait öznitelikleri alır.

void GetSidsAndAttributes(
    CSid::CSidArray* pSids,
    CAtlArray<DWORD>* pAttributes = NULL) const throw(...);

Parametreler

pSids
CSid nesneleri dizisinin işaretçisi.

pAttributes
DWORD dizisi işaretçisi. Bu parametre atlanırsa veya NULL ise, öznitelikler alınmaz.

Açıklamalar

Bu yöntem, nesnede CTokenGroups bulunan tüm CSid nesneleri numaralandırır ve bunları ve (isteğe bağlı olarak) öznitelik bayraklarını dizi nesnelerine yerleştirir.

CTokenGroups::LookupSid

Bir CSid nesneyle ilişkili öznitelikleri alır.

bool LookupSid(
    const CSid& rSid,
    DWORD* pdwAttributes = NULL) const throw();

Parametreler

rSid
CSid nesnesi.

pdwAttributes
Nesnenin özniteliğini kabul CSid edecek bir DWORD işaretçisi. Atlanırsa veya NULL olursa, öznitelik alınmaz.

Dönüş Değeri

bulunursa CSid true, aksi takdirde false döndürür.

Açıklamalar

pdwAttributes değerini NULL olarak ayarlamak, özniteliğine erişmeden varlığını CSid onaylamanın bir yolunu sağlar. Bu yöntemin erişim haklarını denetlemek için kullanılmaması gerektiğini unutmayın. Uygulamalar bunun yerine CAccessToken::CheckTokenMembership yöntemini kullanmalıdır.

CTokenGroups::operator =

Atama işleci.

CTokenGroups& operator= (const TOKEN_GROUPS& rhs) throw(...);
CTokenGroups& operator= (const CTokenGroups& rhs) throw(...);

Parametreler

Rhs
CTokenGroups Nesneye atanacak CTokenGroups nesne veya TOKEN_GROUPS yapısı.

Dönüş Değeri

Güncelleştirilmiş CTokenGroups nesneyi döndürür.

CTokenGroups::operator const TOKEN_GROUPS *

Bir değeri yapıya bir işaretçiye dönüştürür TOKEN_GROUPS .

operator const TOKEN_GROUPS *() const throw(...);

Açıklamalar

bir değeri TOKEN_GROUPS yapısına bir işaretçiye dönüştürür.

Ayrıca bkz.

Güvenlik Örneği
CSid Sınıfı
Sınıfa Genel Bakış
Güvenlik Genel İşlevleri