CSid Class

This class is a wrapper for a SID (security identifier) structure.

Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

class CSid

Members

Public Typedefs

Name

Description

CSid::CSidArray

An array of CSid objects.

Public Constructors

Name

Description

CSid::CSid

The constructor.

CSid::~CSid

The destructor.

Public Methods

Name

Description

CSid::AccountName

Returns the name of the account associated with the CSid object.

CSid::Domain

Returns the name of the domain associated with the CSid object.

CSid::EqualPrefix

Tests SID (security identifier) prefixes for equality.

CSid::GetLength

Returns the length of the CSid object.

CSid::GetPSID

Returns a pointer to a SID structure.

CSid::GetPSID_IDENTIFIER_AUTHORITY

Returns a pointer to the SID_IDENTIFIER_AUTHORITY structure.

CSid::GetSubAuthority

Returns a specified subauthority in a SID structure.

CSid::GetSubAuthorityCount

Returns the subauthority count.

CSid::IsValid

Tests the CSid object for validity.

CSid::LoadAccount

Updates the CSid object given the account name and domain, or an existing SID structure.

CSid::Sid

Returns the ID string.

CSid::SidNameUse

Returns a description of the state of the CSid object.

Operators

operator =

Assignment operator.

operator const SID *

Casts a CSid object to a pointer to a SID structure.

Global Operators

operator ==

Tests two security descriptor objects for equality

operator !=

Tests two security descriptor objects for inequality

operator <

Compares relative value of two security descriptor objects.

operator >

Compares relative value of two security descriptor objects.

operator <=

Compares relative value of two security descriptor objects.

operator >=

Compares relative value of two security descriptor objects.

Remarks

The SID structure is a variable-length structure used to uniquely identify users or groups.

Applications should not modify the SID structure directly, but instead use the methods provided in this wrapper class. See also AtlGetOwnerSid, AtlSetGroupSid, AtlGetGroupSid, and AtlSetOwnerSid.

For an introduction to the access control model in Windows, see Access Control in the Windows SDK.

Requirements

Header: atlsecurity.h

See Also

Concepts

Security Sample

Other Resources

ATL Class Overview

Security Global Functions

ATL Operators Alphabetical Reference