CTokenGroups Class

Essa classe é um wrapper para a estrutura TOKEN_GROUPS.

Importante

Essa classe e os respectivos membros não podem ser usados em aplicativos executados no Windows Runtime.

Sintaxe

class CTokenGroups

Membros

Construtores públicos

Nome	Descrição
CTokenGroups::CTokenGroups	O construtor .
CTokenGroups::~CTokenGroups	O destruidor.

Métodos públicos

Nome	Descrição
CTokenGroups::Add	Adiciona uma estrutura CSid ou TOKEN_GROUPS existente ao objeto CTokenGroups.
CTokenGroups::Delete	Exclui um CSid e seus atributos associados do objeto CTokenGroups.
CTokenGroups::DeleteAll	Exclui todos os objetos CSid e seus atributos associados do objeto CTokenGroups.
CTokenGroups::GetCount	Retorna o número de objetos CSid e atributos associados contidos no objeto CTokenGroups.
CTokenGroups::GetLength	Retorna o tamanho do objeto CTokenGroups.
CTokenGroups::GetPTOKEN_GROUPS	Retorna um ponteiro para a estrutura TOKEN_GROUPS.
CTokenGroups::GetSidsAndAttributes	Recupera os objetos e atributos CSid pertencentes ao objeto CTokenGroups.
CTokenGroups::LookupSid	Recupera os atributos associados a um objeto CSid.

Operadores públicos

Nome	Descrição
CTokenGroups::operator const TOKEN_GROUPS *	Converte o objeto CTokenGroups em um ponteiro para a estrutura TOKEN_GROUPS.
CTokenGroups::operator =	Operador de atribuição.

Comentários

Um token de acesso é um objeto que descreve o contexto de segurança de um processo ou thread e é alocado para cada usuário conectado a um sistema Windows.

A classe CTokenGroups é um wrapper para a estrutura TOKEN_GROUPS , contendo informações sobre SIDs (identificadores de segurança do grupo) em um token de acesso.

Para ver uma introdução ao modelo de controle de acesso no Windows, confira Controle de Acesso no SDK do Windows.

Requisitos

Cabeçalho: atlsecurity.h

CTokenGroups::Add

Adiciona uma estrutura CSid ou TOKEN_GROUPS existente ao objeto CTokenGroups.

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

Parâmetros

rSid
Um objeto CSid.

dwAttributes
Os atributos a serem associados ao objeto CSid.

rTokenGroups
Uma estrutura TOKEN_GROUPS.

Comentários

Esses métodos adicionam um ou mais CSid objetos e seus atributos associados ao objeto CTokenGroups.

CTokenGroups::CTokenGroups

O construtor .

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

Parâmetros

rhs
O objeto CTokenGroups ou TOKEN_GROUPS estrutura com a qual construir o objeto CTokenGroups.

Comentários

O objeto CTokenGroups pode ser criado usando uma estrutura TOKEN_GROUPS ou um objeto CTokenGroups definido anteriormente.

CTokenGroups::~CTokenGroups

O destruidor.

virtual ~CTokenGroups() throw();

Comentários

O destruidor libera todos os recursos alocados.

CTokenGroups::Delete

Exclui um CSid e seus atributos associados do objeto CTokenGroups.

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

Parâmetros

rSid
O objeto CSid para o qual o SID (identificador de segurança) e os atributos devem ser removidos.

Valor de retorno

Retorna true se o CSid for removido, caso contrário, false.

CTokenGroups::DeleteAll

Exclui todos os objetos CSid e seus atributos associados do objeto CTokenGroups.

void DeleteAll() throw();

CTokenGroups::GetCount

Obtém o número de objetos CSid contidos no CTokenGroups.

UINT GetCount() const throw();

Valor de retorno

Retorna o número de objetos CSid e atributos associados contidos no objeto CTokenGroups.

CTokenGroups::GetLength

Retorna o tamanho do objeto CTokenGroup.

UINT GetLength() const throw();

Comentários

O tamanho total do objeto CTokenGroup, em bytes.

CTokenGroups::GetPTOKEN_GROUPS

Retorna um ponteiro para a estrutura TOKEN_GROUPS.

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

Valor de retorno

Recupera um ponteiro para a estrutura TOKEN_GROUPS que pertence ao objeto CTokenGroups do token de acesso.

CTokenGroups::GetSidsAndAttributes

Recupera os objetos CSid e, opcionalmente, os atributos pertencentes ao objeto CTokenGroups.

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

Parâmetros

pSids
Um ponteiro para uma matriz de objetos CSid.

pAttributes
Ponteiro para uma matriz de DWORDs. Se esse parâmetro for omitido ou NULL, os atributos não serão recuperados.

Comentários

Esse método enumerará todos os objetos CSid contidos no objeto CTokenGroups, colocando o nome e (opcionalmente) os sinalizadores de atributo em objetos de matriz.

CTokenGroups::LookupSid

Recupera os atributos associados a um objeto CSid.

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

Parâmetros

rSid
O objeto CSid.

pdwAttributes
Ponteiro para um DWORD que aceitará o atributo do objeto CSid. Se omitido ou NULL, o atributo não será recuperado.

Valor de retorno

Retorna true se o CSid for encontrado, caso contrário, false.

Comentários

Definir pdwAttributes como NULL fornece uma maneira de confirmar a existência do CSid sem acessar o atributo. Observe que esse método não deve ser usado para verificar os direitos de acesso. Em vez disso, os aplicativos devem usar o método CAccessToken::CheckTokenMembership.

CTokenGroups::operator =

Operador de atribuição.

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

Parâmetros

rhs
O objeto CTokenGroups ou estrutura TOKEN_GROUPS a ser atribuída ao objeto CTokenGroups.

Valor de retorno

Retorna o objeto atualizado CTokenGroups.

CTokenGroups::operator const TOKEN_GROUPS *

Converte um valor em um ponteiro para a estrutura TOKEN_GROUPS.

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

Comentários

Converte um valor em um ponteiro para a estrutura TOKEN_GROUPS.

Confira também

Exemplo de Segurança
Classe CSid
Visão geral da aula
Funções globais de segurança