/*
* Process Hacker -
* SAM group handle
*
* Copyright (C) 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 .
*/
using System;
using ProcessHacker.Native.Api;
using ProcessHacker.Native.Security;
namespace ProcessHacker.Native.Objects
{
///
/// Represents a handle to a SAM group.
///
public sealed class SamGroupHandle : SamHandle
{
public static SamGroupHandle Create(SamGroupAccess access, SamDomainHandle domainHandle, string name, out int groupId)
{
IntPtr handle;
UnicodeString nameStr = new UnicodeString(name);
try
{
Win32.SamCreateGroupInDomain(
domainHandle,
ref nameStr,
access,
out handle,
out groupId
).ThrowIf();
}
finally
{
nameStr.Dispose();
}
return new SamGroupHandle(handle, true);
}
public static SamGroupHandle Open(string name, SamGroupAccess access)
{
return Open(Sid.FromName(name), access);
}
public static SamGroupHandle Open(Sid sid, SamGroupAccess access)
{
using (SamDomainHandle dhandle = new SamDomainHandle(sid.DomainName, SamDomainAccess.Lookup))
{
return new SamGroupHandle(dhandle, dhandle.LookupName(sid.Name), access);
}
}
private SamGroupHandle(IntPtr handle, bool owned)
: base(handle, owned)
{ }
///
/// Opens a SAM group.
///
/// A handle to a SAM domain.
/// The relative ID of the group to open.
/// The desired access to the group.
public SamGroupHandle(SamDomainHandle domainHandle, int groupId, SamGroupAccess access)
{
IntPtr handle;
Win32.SamOpenGroup(
domainHandle,
access,
groupId,
out handle
).ThrowIf();
this.Handle = handle;
}
public void AddMember(int memberId)
{
Win32.SamAddMemberToGroup(this, memberId, 0).ThrowIf();
}
public void Delete()
{
Win32.SamDeleteGroup(this).ThrowIf();
}
private SamMemoryAlloc GetInformation(GroupInformationClass infoClass)
{
IntPtr buffer;
Win32.SamQueryInformationGroup(
this,
infoClass,
out buffer
).ThrowIf();
return new SamMemoryAlloc(buffer);
}
public string AdminComment
{
get
{
using (SamMemoryAlloc data = this.GetInformation(GroupInformationClass.GroupAdminCommentInformation))
{
return data.ReadStruct().AdminComment.Text;
}
}
}
public int[] Members
{
get
{
IntPtr memberIds;
IntPtr attributes;
int count;
Win32.SamGetMembersInGroup(
this,
out memberIds,
out attributes,
out count
).ThrowIf();
using (SamMemoryAlloc memberIdsAlloc = new SamMemoryAlloc(memberIds))
using (new SamMemoryAlloc(attributes))
{
return memberIdsAlloc.ReadInt32Array(0, count);
}
}
}
public string Name
{
get
{
using (SamMemoryAlloc data = this.GetInformation(GroupInformationClass.GroupNameInformation))
{
return data.ReadStruct().Name.Text;
}
}
}
public void RemoveMember(int memberId)
{
Win32.SamRemoveMemberFromGroup(this, memberId).ThrowIf();
}
}
}