mirror-processhacker/trunk/ProcessHacker.Native/WindowsSid.cs

/*
 * Process Hacker - 
 *   windows SID wrapper
 * 
 * Copyright (C) 2008-2009 wj32
 * 
 * This file is part of Process Hacker.
 * 
 * Process Hacker is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Process Hacker is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with Process Hacker.  If not, see <http://www.gnu.org/licenses/>.
 */
                
using System;
using System.Runtime.InteropServices;
using System.Security.Principal;
using ProcessHacker.Native.Api;

namespace ProcessHacker.Native
{
    /// <summary>
    /// Represents a Windows security identifier.
    /// </summary>
    public class WindowsSid
    {
        private SecurityIdentifier _id;
        private string _name;
        private string _nameNoDomain;

        /// <summary>
        /// Creates a new WindowsSid instance, specifying a pointer to a SID.
        /// </summary>
        /// <param name="sid">A pointer to a SID.</param>
        public WindowsSid(IntPtr sid)
        {
            _id = new SecurityIdentifier(sid);
            _name = Windows.GetAccountName(sid, true);
            _nameNoDomain = Windows.GetAccountName(sid, false);
        }

        /// <summary>
        /// Gets the name of the user or group which corresponds with this SID.
        /// </summary>
        /// <param name="IncludeDomain">Specifies whether the domain is to be included in the name.</param>
        /// <returns>A string.</returns>
        public string GetName(bool IncludeDomain)
        {
            if (IncludeDomain)
                return _name;
            else
                return _nameNoDomain;
        } 

        /// <summary>
        /// Gets a SecurityIdentifier instance.
        /// </summary>
        public SecurityIdentifier GetSecurityIdentifier()
        {
            return _id;
        }

        /// <summary>
        /// Gets the SID's value using Security Descriptor Definition Language (SDDL).
        /// </summary>
        /// <returns>A string.</returns>
        public string GetStringSID()
        {
            return _id.ToString();
        }
    }
}