Clase CTokenGroups

Esta clase es un contenedor de la estructura TOKEN_GROUPS.

Importante

Esta clase y sus miembros no se pueden usar en las aplicaciones que se ejecutan en Windows Runtime.

Sintaxis

class CTokenGroups

Miembros

Constructores públicos

Nombre	Descripción
CTokenGroups::CTokenGroups	Constructor .
CTokenGroups::~CTokenGroups	El destructor .

Métodos públicos

Nombre	Descripción
CTokenGroups::Add	Agrega una estructura CSid o una estructura TOKEN_GROUPS existente al objeto CTokenGroups.
CTokenGroups::Delete	Elimina CSid y sus atributos asociados del objeto CTokenGroups.
CTokenGroups::DeleteAll	Elimina todos los objetos CSid y sus atributos asociados del objeto CTokenGroups.
CTokenGroups::GetCount	Devuelve el número de objetos CSid y atributos asociados contenidos en el objeto CTokenGroups.
CTokenGroups::GetLength	Devuelve el tamaño del objeto CTokenGroups.
CTokenGroups::GetPTOKEN_GROUPS	Recupera un puntero en la estructura TOKEN_GROUPS.
CTokenGroups::GetSidsAndAttributes	Recupera los objetos y atributos de CSid que pertenecen al objeto CTokenGroups.
CTokenGroups::LookupSid	Recupera los atributos asociados a un objeto CSid.

Operadores públicos

Nombre	Descripción
CTokenGroups::operator const TOKEN_GROUPS *	Convierte un objeto CTokenGroups en un puntero a la estructura TOKEN_GROUPS.
CTokenGroups::operator =	Operador de asignación.

Comentarios

Un token de acceso es un objeto que describe el contexto de seguridad de un proceso o subproceso y que se asigna a cada usuario que ha iniciado sesión en un sistema Windows.

La clase CTokenGroups es un contenedor para la estructura TOKEN_GROUPS, que contiene información sobre los identificadores de seguridad (SID) de grupo en un token de acceso.

Para una introducción al modelo de control de acceso en Windows, consulte Control de acceso en Windows SDK.

Requisitos

Encabezado: atlsecurity.h

CTokenGroups::Add

Agrega una estructura CSid o una estructura TOKEN_GROUPS existente al objeto CTokenGroups.

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

Parámetros

rSid
Objeto CSid.

dwAttributes
Atributos que se van a asociar al objeto CSid.

rTokenGroups
Estructura TOKEN_GROUPS.

Comentarios

Estos métodos agregan uno o varios objetos CSid y sus atributos asociados al objeto CTokenGroups.

CTokenGroups::CTokenGroups

Constructor .

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

Parámetros

rhs
Objeto CTokenGroups o estructura TOKEN_GROUPS con la que se va a construir el objeto CTokenGroups.

Comentarios

Opcionalmente, el objeto CTokenGroups se puede crear mediante una estructura TOKEN_GROUPS o un objeto CTokenGroups definido previamente.

CTokenGroups::~CTokenGroups

El destructor .

virtual ~CTokenGroups() throw();

Comentarios

El destructor libera todos los recursos asignados.

CTokenGroups::Delete

Elimina CSid y sus atributos asociados del objeto CTokenGroups.

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

Parámetros

rSid
Objeto CSid para el que se deben quitar el identificador de seguridad (SID) y los atributos.

Valor devuelto

Devuelve true si se quita CSid, false de lo contrario.

CTokenGroups::DeleteAll

Elimina todos los objetos CSid y sus atributos asociados del objeto CTokenGroups.

void DeleteAll() throw();

CTokenGroups::GetCount

Devuelve el número de objetos CSid incluidos en CTokenGroups.

UINT GetCount() const throw();

Valor devuelto

Devuelve el número de objetos CSid y sus atributos asociados contenidos en el objeto CTokenGroups.

CTokenGroups::GetLength

Devuelve el tamaño del objeto CTokenGroup.

UINT GetLength() const throw();

Comentarios

Devuelve el tamaño total del objeto CTokenGroup, en bytes.

CTokenGroups::GetPTOKEN_GROUPS

Recupera un puntero en la estructura TOKEN_GROUPS.

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

Valor devuelto

Recupera un puntero a la estructura TOKEN_GROUPS que pertenece al objeto de token de acceso CTokenGroups.

CTokenGroups::GetSidsAndAttributes

Recupera los objetos y (opcionalmente) los atributos de CSid que pertenecen al objeto CTokenGroups.

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

Parámetros

pSids
Puntero a una matriz de objetos CSid.

pAttributes
Puntero a una matriz de DWORD. Si se omite este parámetro o es NULL, los atributos no se recuperan.

Comentarios

Este método enumerará todos los objetos CSid contenidos en el objeto CTokenGroups, los colocará en objetos de matriz, y (opcionalmente) también colocará las marcas de atributo.

CTokenGroups::LookupSid

Recupera los atributos asociados a un objeto CSid.

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

Parámetros

rSid
Objeto CSid.

pdwAttributes
Puntero a un DWORD que aceptará el atributo del objeto CSid. Si se omite o es NULL, el atributo no se recuperará.

Valor devuelto

Devuelve true si el archivo CSid existe; en caso contrario, false.

Comentarios

Establecer pdwAttributes en NULL proporciona una manera de confirmar la existencia de CSid sin tener acceso al atributo. Tenga en cuenta que este método no debe usarse para comprobar los derechos de acceso. En su lugar, las aplicaciones deben usar el método CAccessToken::CheckTokenMembership.

CTokenGroups::operator =

Operador de asignación.

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

Parámetros

rhs
Objeto CTokenGroups o estructura TOKEN_GROUPS que se va a asignar al objeto CTokenGroups.

Valor devuelto

Devuelve el objeto CTokenGroups actualizado.

CTokenGroups::operator const TOKEN_GROUPS *

Convierte un valor en un puntero a la estructura TOKEN_GROUPS.

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

Comentarios

Convierte un valor en un puntero a la estructura TOKEN_GROUPS.

Consulte también

Ejemplo de seguridad
CSid (clase)
Información general sobre la clase
Funciones globales de seguridad