CSecurityDescriptor Class Reference

#include <SecurityDescriptor.h>

Collaboration diagram for CSecurityDescriptor:

Public Types
enum	ACEntryType { Unknown , AccessAlowed , AccessDenied , SystemAudit }

Public Member Functions
void	GetCurrentACE_Flags (BYTE &bFlags)
void	GetCurrentACE_AccessMask (DWORD &dwMask)
PSID	GetCurrentACE_SID ()
ACEntryType	GetDACLEntry (DWORD nIndex)
ACEntryType	GetSACLEntry (DWORD nIndex, BOOL &blnFailedAccess, BOOL &blnSeccessfulAccess)
DWORD	GetDACLEntriesCount ()
DWORD	GetSACLEntriesCount ()
BOOL	HasValidDACL ()
BOOL	HasNULLDACL ()
BOOL	HasValidSACL ()
BOOL	HasNULLSACL ()
BOOL	DescriptorContainsDACL ()
BOOL	DescriptorContainsSACL ()
DWORD	BeginDACLInteration ()
DWORD	BeginSACLInteration ()
void	AssociateDescriptor (PSECURITY_DESCRIPTOR pSecurityDescriptor)
	CSecurityDescriptor ()
virtual	~CSecurityDescriptor ()

Private Attributes
PSECURITY_DESCRIPTOR	m_pSecurityDescriptor
BOOL	m_blnDACLPresent
BOOL	m_blnDACLDefaulted
PACL	m_pDACL
BOOL	m_blnSACLPresent
BOOL	m_blnSACLDefaulted
PACL	m_pSACL
ACE_HEADER *	m_pCurrentACEHeader

Detailed Description

Definition at line 17 of file SecurityDescriptor.h.

Member Enumeration Documentation

ACEntryType

enum CSecurityDescriptor::ACEntryType

Enumerator
Unknown
AccessAlowed
AccessDenied
SystemAudit

Definition at line 23 of file SecurityDescriptor.h.

    {
        Unknown,
        AccessAlowed,
        AccessDenied,
        SystemAudit
    };

Constructor & Destructor Documentation

CSecurityDescriptor()

CSecurityDescriptor::CSecurityDescriptor

(

)

Definition at line 135 of file SecurityDescriptor.cpp.

{
    m_pSecurityDescriptor = NULL;
    m_pCurrentACEHeader = NULL;
}

~CSecurityDescriptor()

CSecurityDescriptor::~CSecurityDescriptor ( )

virtual

Definition at line 141 of file SecurityDescriptor.cpp.

{
}

Member Function Documentation

AssociateDescriptor()

void CSecurityDescriptor::AssociateDescriptor

(

PSECURITY_DESCRIPTOR

pSecurityDescriptor

)

Definition at line 145 of file SecurityDescriptor.cpp.

{
    m_pSecurityDescriptor = pSecurityDescriptor;
}

BeginDACLInteration()

DWORD CSecurityDescriptor::BeginDACLInteration

(

)

Definition at line 150 of file SecurityDescriptor.cpp.

{
    if (!GetSecurityDescriptorDacl(m_pSecurityDescriptor,&m_blnDACLPresent,&m_pDACL,&m_blnDACLDefaulted))
    {
        throw GetLastError();
    }
    return ERROR_SUCCESS;
}

BeginSACLInteration()

DWORD CSecurityDescriptor::BeginSACLInteration

(

)

Definition at line 164 of file SecurityDescriptor.cpp.

{
    if (!GetSecurityDescriptorSacl(m_pSecurityDescriptor,&m_blnSACLPresent,&m_pSACL,&m_blnSACLDefaulted))
        throw GetLastError();
    return ERROR_SUCCESS;
}

DescriptorContainsDACL()

BOOL CSecurityDescriptor::DescriptorContainsDACL

(

)

Definition at line 159 of file SecurityDescriptor.cpp.

{
    return m_blnDACLPresent;
}

DescriptorContainsSACL()

BOOL CSecurityDescriptor::DescriptorContainsSACL

(

)

Definition at line 171 of file SecurityDescriptor.cpp.

{
    return m_blnSACLPresent;
}

GetCurrentACE_AccessMask()

void CSecurityDescriptor::GetCurrentACE_AccessMask

(

DWORD &

dwMask

)

Definition at line 265 of file SecurityDescriptor.cpp.

{
    ASSERT(m_pCurrentACEHeader != NULL);
    switch(m_pCurrentACEHeader->AceType)
    {
    case ACCESS_ALLOWED_ACE_TYPE:
        dwMask = (((ACCESS_ALLOWED_ACE *)m_pCurrentACEHeader)->Mask);
        return;
    case ACCESS_DENIED_ACE_TYPE:
        dwMask = (((ACCESS_DENIED_ACE *)m_pCurrentACEHeader)->Mask);
        return;
    case SYSTEM_AUDIT_ACE_TYPE:
        dwMask = (((SYSTEM_AUDIT_ACE *)m_pCurrentACEHeader)->Mask);
        return;
    default:
        ASSERT(FALSE);  // Do not call this function for unknown ACE types !!!
        return;
    }
}

GetCurrentACE_Flags()

void CSecurityDescriptor::GetCurrentACE_Flags

(

BYTE &

bFlags

)

Definition at line 285 of file SecurityDescriptor.cpp.

{
    ASSERT(m_pCurrentACEHeader != NULL);
  bFlags = m_pCurrentACEHeader->AceFlags;
}

GetCurrentACE_SID()

PSID CSecurityDescriptor::GetCurrentACE_SID

(

)

Definition at line 248 of file SecurityDescriptor.cpp.

{
    ASSERT(m_pCurrentACEHeader != NULL);
    switch(m_pCurrentACEHeader->AceType)
    {
    case ACCESS_ALLOWED_ACE_TYPE:
        return ((PSID)&(((ACCESS_ALLOWED_ACE *)m_pCurrentACEHeader)->SidStart));
    case ACCESS_DENIED_ACE_TYPE:
        return ((PSID)&(((ACCESS_DENIED_ACE *)m_pCurrentACEHeader)->SidStart));
    case SYSTEM_AUDIT_ACE_TYPE:
        return ((PSID)&(((SYSTEM_AUDIT_ACE *)m_pCurrentACEHeader)->SidStart));
    default:
        ASSERT(FALSE);  // Do not call this function for unknown ACE types !!!
        return NULL;
    }
}

GetDACLEntriesCount()

DWORD CSecurityDescriptor::GetDACLEntriesCount

(

)

Definition at line 202 of file SecurityDescriptor.cpp.

{
    ACL_SIZE_INFORMATION SizeInfo;
    if (!GetAclInformation(m_pDACL,&SizeInfo,sizeof(SizeInfo),AclSizeInformation))
        throw GetLastError();
    return SizeInfo.AceCount;
}

GetDACLEntry()

CSecurityDescriptor::ACEntryType CSecurityDescriptor::GetDACLEntry

(

DWORD

nIndex

)

Definition at line 218 of file SecurityDescriptor.cpp.

{
    void *pACE;
    if (!GetAce(m_pDACL,nIndex,&pACE)) throw GetLastError();
    m_pCurrentACEHeader = (PACE_HEADER)pACE;
    if (m_pCurrentACEHeader->AceType == ACCESS_ALLOWED_ACE_TYPE)
    {
        return AccessAlowed;
    }
    if (m_pCurrentACEHeader->AceType == ACCESS_DENIED_ACE_TYPE)
    {
        return AccessDenied;
    }
    return Unknown;
}

GetSACLEntriesCount()

DWORD CSecurityDescriptor::GetSACLEntriesCount

(

)

Definition at line 210 of file SecurityDescriptor.cpp.

{
    ACL_SIZE_INFORMATION SizeInfo;
    if (!GetAclInformation(m_pSACL,&SizeInfo,sizeof(SizeInfo),AclSizeInformation))
        throw GetLastError();
    return SizeInfo.AceCount;
}

GetSACLEntry()

CSecurityDescriptor::ACEntryType CSecurityDescriptor::GetSACLEntry	(	DWORD	nIndex,
		BOOL &	blnFailedAccess,
		BOOL &	blnSeccessfulAccess
	)

Definition at line 234 of file SecurityDescriptor.cpp.

{
    void *pACE;
    if (!GetAce(m_pSACL,nIndex,&pACE)) throw GetLastError();
    m_pCurrentACEHeader = (PACE_HEADER)pACE;
    if (m_pCurrentACEHeader->AceType == SYSTEM_AUDIT_ACE_TYPE)
    {
        blnFailedAccess = m_pCurrentACEHeader->AceFlags & FAILED_ACCESS_ACE_FLAG;
        blnSeccessfulAccess = m_pCurrentACEHeader->AceFlags & SUCCESSFUL_ACCESS_ACE_FLAG;
        return SystemAudit;
    }
    return Unknown;
}

HasNULLDACL()

BOOL CSecurityDescriptor::HasNULLDACL

(

)

Definition at line 176 of file SecurityDescriptor.cpp.

{
    ASSERT(m_blnDACLPresent);
    return (m_pDACL == NULL);
}

HasNULLSACL()

BOOL CSecurityDescriptor::HasNULLSACL

(

)

Definition at line 189 of file SecurityDescriptor.cpp.

{
    ASSERT(m_blnSACLPresent);
    return (m_pSACL == NULL);
}

HasValidDACL()

BOOL CSecurityDescriptor::HasValidDACL

(

)

Definition at line 182 of file SecurityDescriptor.cpp.

{
    ASSERT(m_blnDACLPresent);
    ASSERT(m_pDACL != NULL);
    return IsValidAcl(m_pDACL);
}

HasValidSACL()

BOOL CSecurityDescriptor::HasValidSACL

(

)

Definition at line 195 of file SecurityDescriptor.cpp.

{
    ASSERT(m_blnSACLPresent);
    ASSERT(m_pSACL != NULL);
    return IsValidAcl(m_pSACL);
}

Member Data Documentation

m_blnDACLDefaulted

BOOL CSecurityDescriptor::m_blnDACLDefaulted

private

Definition at line 48 of file SecurityDescriptor.h.

Referenced by BeginDACLInteration().

m_blnDACLPresent

BOOL CSecurityDescriptor::m_blnDACLPresent

private

Definition at line 47 of file SecurityDescriptor.h.

Referenced by BeginDACLInteration(), DescriptorContainsDACL(), HasNULLDACL(), and HasValidDACL().

m_blnSACLDefaulted

BOOL CSecurityDescriptor::m_blnSACLDefaulted

private

Definition at line 51 of file SecurityDescriptor.h.

Referenced by BeginSACLInteration().

m_blnSACLPresent

BOOL CSecurityDescriptor::m_blnSACLPresent

private

Definition at line 50 of file SecurityDescriptor.h.

Referenced by BeginSACLInteration(), DescriptorContainsSACL(), HasNULLSACL(), and HasValidSACL().

m_pCurrentACEHeader

ACE_HEADER* CSecurityDescriptor::m_pCurrentACEHeader

private

Definition at line 53 of file SecurityDescriptor.h.

Referenced by CSecurityDescriptor(), GetCurrentACE_AccessMask(), GetCurrentACE_Flags(), GetCurrentACE_SID(), GetDACLEntry(), and GetSACLEntry().

m_pDACL

PACL CSecurityDescriptor::m_pDACL

private

Definition at line 49 of file SecurityDescriptor.h.

Referenced by BeginDACLInteration(), GetDACLEntriesCount(), GetDACLEntry(), HasNULLDACL(), and HasValidDACL().

m_pSACL

PACL CSecurityDescriptor::m_pSACL

private

Definition at line 52 of file SecurityDescriptor.h.

Referenced by BeginSACLInteration(), GetSACLEntriesCount(), GetSACLEntry(), HasNULLSACL(), and HasValidSACL().

m_pSecurityDescriptor

PSECURITY_DESCRIPTOR CSecurityDescriptor::m_pSecurityDescriptor

private

Definition at line 46 of file SecurityDescriptor.h.

Referenced by AssociateDescriptor(), BeginDACLInteration(), BeginSACLInteration(), and CSecurityDescriptor().

---

The documentation for this class was generated from the following files:

• modules/rosapps/applications/sysutils/regexpl/SecurityDescriptor.h
• modules/rosapps/applications/sysutils/regexpl/SecurityDescriptor.cpp