CTokenGroups, classe

Cette classe est un wrapper pour la TOKEN_GROUPS structure.

Syntaxe

class CTokenGroups

Membres

Constructeurs publics

Méthodes publiques

Opérateurs publics

Notes

Un jeton d’accès est un objet qui décrit le contexte de sécurité d’un processus ou d’un thread et qui est alloué à chaque utilisateur connecté à un système Windows.

La CTokenGroups classe est un wrapper pour la structure TOKEN_GROUPS , contenant des informations sur les identificateurs de sécurité de groupe (SID) dans un jeton d’accès.

Pour une présentation du modèle de contrôle d’accès dans Windows, consultez Contrôle d’accès dans le Kit de développement logiciel (SDK) Windows.

Spécifications

En-tête : atlsecurity.h

CTokenGroups ::Add

Ajoute une CSid structure ou une structure existante TOKEN_GROUPS à l’objet CTokenGroups .

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

Paramètres

rSid
Objet CSid .

dwAttributes
Attributs à associer à l’objet CSid .

rTokenGroups
Structure TOKEN_GROUPS .

Notes

Ces méthodes ajoutent un ou plusieurs CSid objets et leurs attributs associés à l’objet CTokenGroups .

CTokenGroups ::CTokenGroups

Constructeur .

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

Paramètres

rhs
Objet CTokenGroups ou structure TOKEN_GROUPS avec laquelle construire l’objet CTokenGroups .

Notes

L’objet CTokenGroups peut éventuellement être créé à l’aide d’une TOKEN_GROUPS structure ou d’un objet précédemment défini CTokenGroups .

CTokenGroups ::~CTokenGroups

Destructeur.

virtual ~CTokenGroups() throw();

Notes

Le destructeur libère toutes les ressources allouées.

CTokenGroups ::D elete

Supprime un CSid et ses attributs associés de l’objet CTokenGroups .

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

Paramètres

rSid
Objet CSid pour lequel l’identificateur de sécurité (SID) et les attributs doivent être supprimés.

Valeur de retour

Retourne true si la CSid valeur est supprimée, false dans le cas contraire.

CTokenGroups ::D eleteAll

Supprime tous les CSid objets et leurs attributs associés de l’objet CTokenGroups .

void DeleteAll() throw();

CTokenGroups ::GetCount

Retourne le nombre d’objets CSid contenus dans CTokenGroups.

UINT GetCount() const throw();

Valeur de retour

Retourne le nombre d’objets CSid et leurs attributs associés contenus dans l’objet CTokenGroups .

CTokenGroups ::GetLength

Retourne la taille de l’objet CTokenGroup .

UINT GetLength() const throw();

Notes

Retourne la taille totale de l’objet CTokenGroup , en octets.

CTokenGroups ::GetPTOKEN_GROUPS

Récupère un pointeur vers la TOKEN_GROUPS structure.

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

Valeur de retour

Récupère un pointeur vers la structure TOKEN_GROUPS appartenant à l’objet de CTokenGroups jeton d’accès.

CTokenGroups ::GetSidsAndAttributes

Récupère les CSid objets et (éventuellement) les attributs appartenant à l’objet CTokenGroups .

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

Paramètres

pSids
Pointeur vers un tableau d’objets CSid .

pAttributes
Pointeur vers un tableau de DWORDs. Si ce paramètre est omis ou NULL, les attributs ne sont pas récupérés.

Notes

Cette méthode énumère tous les CSid objets contenus dans l’objet CTokenGroups et les place et (éventuellement) les indicateurs d’attribut dans des objets de tableau.

CTokenGroups ::LookupSid

Récupère les attributs associés à un CSid objet.

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

Paramètres

rSid
Objet CSid .

pdwAttributes
Pointeur vers un DWORD qui accepte l’attribut de l’objet CSid . S’il est omis ou NULL, l’attribut n’est pas récupéré.

Valeur de retour

Retourne true si la CSid valeur est trouvée, false dans le cas contraire.

Notes

La définition de pdwAttributes sur NULL permet de confirmer l’existence de l’attribut CSid sans accéder à l’attribut. Notez que cette méthode ne doit pas être utilisée pour vérifier les droits d’accès. Les applications doivent plutôt utiliser la méthode CAccessToken ::CheckTokenMembership .

CTokenGroups ::operator =

Opérateur d'assignation.

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

Paramètres

rhs
Objet CTokenGroups ou structure TOKEN_GROUPS à affecter à l’objet CTokenGroups .

Valeur de retour

Retourne l’objet mis à jour CTokenGroups .

CTokenGroups ::operator const TOKEN_GROUPS *

Convertit une valeur en pointeur vers la TOKEN_GROUPS structure.

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

Notes

Convertit une valeur en pointeur vers la structure TOKEN_GROUPS .

Voir aussi

Exemple de sécurité
CSid, classe
Vue d’ensemble de la classe
Fonctions globales de sécurité