CTokenGroups 클래스

이 클래스는 구조체에 대한 래퍼입니다 TOKEN_GROUPS .

Important

이 클래스와 해당 멤버는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다.

구문

class CTokenGroups

멤버

공용 생성자

속성	설명
CTokenGroups::CTokenGroups	생성자입니다.
CTokenGroups::~CTokenGroups	소멸자입니다.

공용 메서드

이름	설명
CTokenGroups::Add	개체에 CSid 기존 TOKEN_GROUPS 구조 CTokenGroups 체를 추가합니다.
CTokenGroups::D 삭제	개체에서 CTokenGroups A CSid 및 관련 특성을 삭제합니다.
CTokenGroups::D eleteAll	개체에서 CTokenGroups 모든 CSid 개체 및 관련 특성을 삭제합니다.
CTokenGroups::GetCount	개체에 포함된 CTokenGroups 개체 및 관련 특성의 CSid 수를 반환합니다.
CTokenGroups::GetLength	개체의 CTokenGroups 크기를 반환합니다.
CTokenGroups::GetPTOKEN_GROUPS	구조체에 대한 포인터를 검색합니다 TOKEN_GROUPS .
CTokenGroups::GetSidsAndAttributes	개체에 CSid 속하는 개체 및 특성을 검색 CTokenGroups 합니다.
CTokenGroups::LookupSid	개체와 CSid 연결된 특성을 검색합니다.

Public 연산자

이름	설명
CTokenGroups::operator const TOKEN_GROUPS *	개체를 구조체 CTokenGroups 에 대한 포인터로 캐스팅합니다 TOKEN_GROUPS .
CTokenGroups::operator =	대입 연산자입니다.

설명

액세스 토큰은 프로세스 또는 스레드의 보안 컨텍스트를 설명하는 개체이며 Windows 시스템에 로그온한 각 사용자에게 할당됩니다.

CTokenGroups 클래스는 액세스 토큰의 SID(그룹 보안 식별자)에 대한 정보를 포함하는 TOKEN_GROUPS 구조에 대한 래퍼입니다.

Windows의 액세스 제어 모델에 대한 소개는 Windows SDK의 Access Control을 참조하세요.

요구 사항

헤더: atlsecurity.h

CTokenGroups::Add

개체에 CSid 기존 TOKEN_GROUPS 구조 CTokenGroups 체를 추가합니다.

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

매개 변수

rSid
CSid 개체입니다.

dwAttributes
개체와 연결할 특성입니다 CSid .

rTokenGroups
TOKEN_GROUPS 구조체입니다.

설명

이러한 메서드는 개체에 하나 이상의 CSid 개체와 관련 특성을 CTokenGroups 추가합니다.

CTokenGroups::CTokenGroups

생성자입니다.

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

매개 변수

rhs
CTokenGroups 개체를 생성할 개체 또는 TOKEN_GROUPS 구조체입니다CTokenGroups.

설명

CTokenGroups 필요에 따라 구조체 또는 이전에 정의된 CTokenGroups 개체를 TOKEN_GROUPS 사용하여 개체를 만들 수 있습니다.

CTokenGroups::~CTokenGroups

소멸자입니다.

virtual ~CTokenGroups() throw();

설명

소멸자가 할당된 모든 리소스를 해제합니다.

CTokenGroups::D 삭제

개체에서 CTokenGroups A CSid 및 관련 특성을 삭제합니다.

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

매개 변수

rSid
SID(보안 식별자) 및 특성을 제거해야 하는 CSid 개체입니다.

Return Value

제거되면 true를 CSid 반환하고, 그렇지 않으면 false를 반환합니다.

CTokenGroups::D eleteAll

개체에서 CTokenGroups 모든 CSid 개체 및 관련 특성을 삭제합니다.

void DeleteAll() throw();

CTokenGroups::GetCount

에 포함된 CTokenGroups개체 수를 CSid 반환합니다.

UINT GetCount() const throw();

Return Value

개체에 포함된 CTokenGroups CSid 개체 및 관련 특성의 수를 반환합니다.

CTokenGroups::GetLength

개체의 CTokenGroup 크기를 반환합니다.

UINT GetLength() const throw();

설명

개체의 CTokenGroup 총 크기를 바이트 단위로 반환합니다.

CTokenGroups::GetPTOKEN_GROUPS

구조체에 대한 포인터를 검색합니다 TOKEN_GROUPS .

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

Return Value

액세스 토큰 개체에 속하는 TOKEN_GROUPS 구조체에 대한 포인터를 CTokenGroups 검색합니다.

CTokenGroups::GetSidsAndAttributes

개체를 CSid 검색하고(선택적으로) 개체에 속하는 CTokenGroups 특성을 검색합니다.

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

매개 변수

pSids
CSid 개체의 배열에 대한 포인터입니다.

pAttributes
DWORD 배열에 대한 포인터입니다. 이 매개 변수를 생략하거나 NULL이면 특성이 검색되지 않습니다.

설명

이 메서드는 개체에 CTokenGroups 포함된 모든 개체를 CSid 열거하고 해당 개체를 배치하고(선택적으로) 특성 플래그를 배열 개체에 배치합니다.

CTokenGroups::LookupSid

개체와 CSid 연결된 특성을 검색합니다.

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

매개 변수

rSid
CSid 개체입니다.

pdwAttributes
개체의 특성을 수락할 DWORD에 대한 CSid 포인터입니다. 생략하거나 NULL이면 특성이 검색되지 않습니다.

Return Value

발견되면 true를 CSid 반환하고, 그렇지 않으면 false를 반환합니다.

설명

pdwAttributes를 NULL로 설정하면 특성에 액세스하지 않고 존재 CSid 할 수 있는지 확인할 수 있습니다. 이 메서드는 액세스 권한을 검사 데 사용하면 안 됩니다. 애플리케이션은 대신 CAccessToken::CheckTokenMembership 메서드를 사용해야 합니다.

CTokenGroups::operator =

대입 연산자입니다.

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

매개 변수

rhs
CTokenGroups 개체에 할당할 개체 또는 TOKEN_GROUPS 구조체입니다CTokenGroups.

Return Value

업데이트 CTokenGroups 된 개체를 반환합니다.

CTokenGroups::operator const TOKEN_GROUPS *

값을 구조체에 대한 포인터로 캐스팅합니다 TOKEN_GROUPS .

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

설명

값을 TOKEN_GROUPS 구조체에 대한 포인터로 캐스팅합니다.

참고 항목

보안 샘플
CSid 클래스
클래스 개요
보안 전역 함수