---

ace.h

Go to the documentation of this file.

// ace.h: DO NOT include this file. #include fksec.h instead!



#if ! defined( AFX_ACE_H__C2404C08_2791_41F1_A45E_A62EF7364105__INCLUDED_ )
#define AFX_ACE_H__C2404C08_2791_41F1_A45E_A62EF7364105__INCLUDED_
#pragma once





namespace fksec {

    class ace
    {
    public:
        // --- ctors/dtor ---
        ace();
        ace( const ace &a );
        ace( const void *a );
        ace( byte type, byte flags, byte inheritance, ACCESS_MASK mask, const sid &newSid,
            const GUID &ObjectType = GUID_NULL, const GUID &InheritedObjectType = GUID_NULL );

        virtual ~ace();

        // --- assignment ---
        const ace &operator=( const ace &s );
        const ace &operator=( const void *s );

        // --- conversions ---
        operator const void *() const;

        // --- comparisons ---
        bool operator==( const ace &r );
        bool operator!=( const ace &r );
        bool operator<( const ace &r );

        // --- accessors ---


        byte GetType() const { return aceType; }

        byte GetFlags() const { return aceFlags; }

        ACCESS_MASK GetMask() const { return aceMask; }

        DWORD GetSize() const { return GetLength(); }

        byte GetInheritance() const { return aceInheritance; }

        const sid &GetSid() const { return aceSid; }


        DWORD GetObjectFlags() const { return aceObjectFlags ; }

        bool  HasObjectType() const { return ( aceObjectFlags & ACE_OBJECT_TYPE_PRESENT ) ? true : false ; }

        bool  HasInheritedObjectType() const { return (aceObjectFlags & ACE_INHERITED_OBJECT_TYPE_PRESENT) ? true : false ; }

        const GUID &GetObjectType() const { return aceObjectTypeGUID ; }

        const GUID &GetInheritedObjectType() const { return aceInheritedObjectTypeGUID ; }

        void SetType( byte newType );
        void SetFlags( byte newFlags );
        void SetMask( ACCESS_MASK newMask );
        void SetInheritance( byte newInheritance );
        void SetSid( const sid &newSid );
        void SetSid( const TCHAR *stringSid );


        void SetObjectType(const GUID &ObjectType ) ;
        void RemoveObjectType() ;

        void SetInheritedObjectType(const GUID &InheritedObjectType ) ;
        void RemoveInheritedObjectType() ;

        // --- utilities ---
        DWORD GetLength() const;
        void StoreAce( void *p, DWORD sz ) const;
        bool IsValid() const;

        bool IsObjectACE() const ;

        // --- inserters ---
        friend fkostream &operator<<( fkostream &o, const ace &a );

        enum AceSortOrder {
            asoDefault,
            asoNT4,
            asoNT5
        };

        static AceSortOrder GetAceSortOrder();

        static void SetAceSortOrder( AceSortOrder aso );

    private:
        void ClearPACE() const;
        void ReleasePACE() const;
        void *MakePACE() const;
        void InitFromPACE( const void *a );

        static AceSortOrder currentAceSortOrder;

        // keep track of components we have
        bool haveAceType;
        bool haveAceFlags;
        bool haveAceMask;
        bool haveAceInheritance;
        // no "haveAceSid" -- aceSid.IsValid() serves here

        // ACE components
        byte aceType;
        byte aceFlags;
        byte aceInheritance;
        ACCESS_MASK aceMask;
        fksec::sid aceSid;

        DWORD aceObjectFlags ;
        GUID aceObjectTypeGUID ;
        GUID aceInheritedObjectTypeGUID ; 

        mutable bool havePACE;
        mutable ACCESS_ALLOWED_ACE *pace;
    };

    fkostream &operator<<( fkostream &o, const ace &a );

} // namespace fksec

#endif // ! defined( AFX_ACE_H__C2404C08_2791_41F1_A45E_A62EF7364105__INCLUDED_ )

---