Kelas CTokenGroups

Kelas ini adalah pembungkus untuk TOKEN_GROUPS struktur.

Sintaks

class CTokenGroups

Anggota

Konstruktor Publik

Metode Publik

Operator Publik

Keterangan

Token akses adalah objek yang menjelaskan konteks keamanan proses atau utas dan dialokasikan untuk setiap pengguna yang masuk ke sistem Windows.

Kelas CTokenGroups adalah pembungkus untuk struktur TOKEN_GROUPS , berisi informasi tentang pengidentifikasi keamanan grup (SID) dalam token akses.

Untuk pengenalan model kontrol akses di Windows, lihat Kontrol Akses di Windows SDK.

Persyaratan

Header: atlsecurity.h

CTokenGroups::Add

CSid Menambahkan struktur atau yang TOKEN_GROUPS sudah ada ke CTokenGroups objek.

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

Parameter

rSid
Objek CSid .

dwAttributes
Atribut yang akan dikaitkan CSid dengan objek .

rTokenGroups
Struktur TOKEN_GROUPS .

Keterangan

Metode ini menambahkan satu atau beberapa CSid objek dan atribut terkait ke CTokenGroups objek.

CTokenGroups::CTokenGroups

Konstruktor.

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

Parameter

rhs
Objek CTokenGroups atau struktur TOKEN_GROUPS untuk membangun CTokenGroups objek.

Keterangan

Objek CTokenGroups dapat secara opsional dibuat menggunakan TOKEN_GROUPS struktur atau objek yang ditentukan CTokenGroups sebelumnya.

CTokenGroups::~CTokenGroups

Destruktor.

virtual ~CTokenGroups() throw();

Keterangan

Destruktor membebaskan semua sumber daya yang dialokasikan.

CTokenGroups::D elete

CSid Menghapus dan atribut terkait dari CTokenGroups objek.

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

Parameter

rSid
Objek CSid tempat pengidentifikasi keamanan (SID) dan atribut harus dihapus.

Tampilkan Nilai

Mengembalikan true jika CSid dihapus, salah jika tidak.

CTokenGroups::D eleteAll

Menghapus semua CSid objek dan atribut terkait dari CTokenGroups objek.

void DeleteAll() throw();

CTokenGroups::GetCount

Mengembalikan jumlah CSid objek yang terkandung dalam CTokenGroups.

UINT GetCount() const throw();

Tampilkan Nilai

Mengembalikan jumlah objek CSid dan atribut terkait yang terkandung dalam CTokenGroups objek.

CTokenGroups::GetLength

Mengembalikan ukuran CTokenGroup objek.

UINT GetLength() const throw();

Keterangan

Mengembalikan ukuran CTokenGroup total objek, dalam byte.

CTokenGroups::GetPTOKEN_GROUPS

Mengambil penunjuk ke TOKEN_GROUPS struktur.

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

Tampilkan Nilai

Mengambil penunjuk ke struktur TOKEN_GROUPS milik CTokenGroups objek token akses.

CTokenGroups::GetSidsAndAttributes

CSid Mengambil objek dan (opsional) atribut milik CTokenGroups objek.

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

Parameter

pSids
Penunjuk ke array objek CSid .

pAttributes
Penunjuk ke array DWORD. Jika parameter ini dihilangkan atau NULL, atribut tidak diambil.

Keterangan

Metode ini akan menghitung semua CSid objek yang terkandung dalam CTokenGroups objek dan menempatkannya dan (opsional) bendera atribut ke dalam objek array.

CTokenGroups::LookupSid

Mengambil atribut yang terkait dengan CSid objek.

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

Parameter

rSid
Objek CSid .

pdwAttributes
Pointer ke DWORD yang akan menerima CSid atribut objek. Jika dihilangkan atau NULL, atribut tidak akan diambil.

Tampilkan Nilai

Mengembalikan true jika CSid ditemukan, salah jika tidak.

Keterangan

Mengatur pdwAttributes ke NULL menyediakan cara untuk mengonfirmasi keberadaan CSid tanpa mengakses atribut. Perhatikan bahwa metode ini tidak boleh digunakan untuk memeriksa hak akses. Aplikasi harus menggunakan metode CAccessToken::CheckTokenMembership .

CTokenGroups::operator =

Operator penugasan.

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

Parameter

rhs
Objek CTokenGroups atau struktur TOKEN_GROUPS untuk ditetapkan ke CTokenGroups objek.

Tampilkan Nilai

Mengembalikan objek yang diperbarui CTokenGroups .

CTokenGroups::operator const TOKEN_GROUPS *

Melemparkan nilai ke penunjuk ke TOKEN_GROUPS struktur.

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

Keterangan

Melemparkan nilai ke penunjuk ke struktur TOKEN_GROUPS .

Lihat juga

Sampel Keamanan
Kelas CSid
Gambaran Umum Kelas
Fungsi Global Keamanan