Classe CTokenGroups

Esta classe é um envelope para a TOKEN_GROUPS estrutura.

Sintaxe

class CTokenGroups

Membros

Construtores Públicos

Métodos Públicos

Operadores Públicos

Observações

Um token de acesso é um objeto que descreve o contexto de segurança de um processo ou thread e é alocado a cada utilizador iniciado num sistema Windows.

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

Para uma introdução ao modelo de controlo de acesso no Windows, veja Controlo de Acesso no SDK do Windows.

Requerimentos

Cabeçalho: atlsecurity.h

CTokenGroups::Add

Adiciona uma CSid ou estrutura existente TOKEN_GROUPS ao CTokenGroups objeto.

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 associar ao CSid objeto.

rTokenGroups
Uma estrutura TOKEN_GROUPS .

Observações

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

CTokenGroups::CTokenGroups

O construtor.

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

Parâmetros

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

Observações

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

CTokenGroups::~CTokenGroups

O destruidor.

virtual ~CTokenGroups() throw();

Observações

O destruidor liberta todos os recursos alocados.

CTokenGroups::D elete

Apaga a CSid e os seus atributos associados do CTokenGroups objeto.

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

Parâmetros

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

Valor de retorno

Retorna verdadeiro se for removido CSid , falso caso contrário.

CTokenGroups::D eleteAll

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

void DeleteAll() throw();

CTokenGroups::GetCount

Devolve o número de CSid objetos contidos em CTokenGroups.

UINT GetCount() const throw();

Valor de retorno

Devolve o número de objetos CSid e os seus atributos associados contidos no CTokenGroups objeto.

CTokenGroups::GetLength

Devolve o tamanho do CTokenGroup objeto.

UINT GetLength() const throw();

Observações

Devolve o tamanho total do CTokenGroup objeto, em bytes.

CTokenGroups::GetPTOKEN_GROUPS

Recupera um apontador para a TOKEN_GROUPS estrutura.

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

Valor de retorno

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

CTokenGroups::GetSidsAndAttributes

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

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

Parâmetros

pSids
Apontar para um array de objetos CSid .

pAtributos
Apontar para um array de DWORDs. Se este parâmetro for omitido ou NULL, os atributos não são recuperados.

Observações

Este método enumera todos os CSid objetos contidos no CTokenGroups objeto e coloca-os, e (opcionalmente) os flags de atributo nos objetos do array.

CTokenGroups::LookupSid

Recupera os atributos associados a um CSid objeto.

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

Parâmetros

rSid
O objeto CSid .

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

Valor de retorno

Retorna verdadeiro se o for encontrado CSid , falso caso contrário.

Observações

Definir pdwAttributes para NULL fornece uma forma de confirmar a existência do CSid sem aceder ao atributo. Note que este método não deve ser usado para verificar direitos de acesso. As aplicações devem antes utilizar 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 CTokenGroups objeto ou TOKEN_GROUPS estrutura a atribuir ao CTokenGroups objeto.

Valor de retorno

Devolve o objeto atualizado CTokenGroups .

CTokenGroups::operator const TOKEN_GROUPS *

Atribui um valor a um apontador para a TOKEN_GROUPS estrutura.

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

Observações

Lança um valor para um ponteiro para a estrutura TOKEN_GROUPS .

Consulte também

Exemplo de Segurança
CSid Classe
Visão geral da classe
Funções Globais de Segurança