using System;
using System.IO;
using System.Windows.Forms;
using System.Collections;
using System.Xml;
using System.Runtime.InteropServices;
//**********************************************************************
//** Create By: 熊鹰
//** Create Date: 2006-07-20
//** Description: 操作本地用户和组的类
//** Modify List:
//**********************************************************************
namespace LocalGroupUserTest
{
/// <summary>
/// ------------------熊鹰的测试代码 ------------------
/// LocalGroupUserHelper helper=new LocalGroupUserHelper();
/// helper.AddUser(null,"Test","1","Test User Comments");
/// helper.RemoveUser(null,"Test");
/// helper.UpdateUser(null,"Test");
/// helper.ModifyUserPassword(null,"Test","1","11");
/// helper.GetUserInfo(null,"Test");
/// helper.GetAllUserInfo(null);
/// helper.UserInLocalGroups(null,"Test");
///
/// helper.AddGroup(null,"Tests","Tests Group Comments");
/// helper.GroupAddMembers(null,"Tests","kevin\\Administrator");
///
/// 下面的代码中，因为时间的关系，我只写了有关创建本地组、将用户添加到某本地组、添加、删除、修改某本地用户等方法。
/// 如果，项目业务需求中有更多的功能要求，请自行扩展相关代码。
/// 下面的代码中主要引用Win32库"Netapi32.dll"，相关函数和结构如下（更详细的信息请参考MSDN）：
/// NetUserAdd
/// NetUserChangePassword
/// NetUserDel
/// NetUserEnum
/// NetUserGetGroups
/// NetUserGetInfo
/// NetUserGetLocalGroups
/// NetUserModalsGet
/// NetUserModalsSet
/// NetUserSetGroups
/// NetUserSetInfo
/// NetValidateName
/// NetValidatePasswordPolicy
/// NetValidatePasswordPolicyFree
/// USER_INFO_0
/// USER_INFO_1
///
/// NetLocalGroupAdd
/// NetLocalGroupAddMember
/// NetLocalGroupAddMembers
/// NetLocalGroupDel
/// NetLocalGroupDelMember
/// NetLocalGroupDelMembers
/// NetLocalGroupEnum
/// NetLocalGroupGetInfo
/// NetLocalGroupGetMembers
/// NetLocalGroupSetInfo
/// NetLocalGroupSetMembers
/// LOCALGROUP_INFO_0
/// LOCALGROUP_INFO_1
/// LOCALGROUP_INFO_1002
/// LOCALGROUP_MEMBERS_INFO_0
/// LOCALGROUP_MEMBERS_INFO_1
/// LOCALGROUP_MEMBERS_INFO_2
/// LOCALGROUP_MEMBERS_INFO_3
/// LOCALGROUP_USERS_INFO_0
/// ……
public class LocalGroupUserHelper
{
[DllImport("Netapi32.dll")]
extern static int NetUserAdd([MarshalAs(UnmanagedType.LPWStr)] string servername, int level, ref USER_INFO_1 buf, int parm_err);
[DllImport("Netapi32.dll")]
extern static int NetLocalGroupAdd([MarshalAs(UnmanagedType.LPWStr)] string servername, int level, ref LOCALGROUP_INFO_1 buf, int parm_err);
[DllImport("Netapi32.dll")]
extern static int NetLocalGroupAddMembers([MarshalAs(UnmanagedType.LPWStr)] string servername, [MarshalAs(UnmanagedType.LPWStr)] string groupname,
int level, ref LOCALGROUP_MEMBERS_INFO_3 buf, int totalentries);
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LOCALGROUP_MEMBERS_INFO_3
{
public string domainandname; //<DomainName>\<AccountName> //lgrmi3_domainandname
}
[DllImport("Netapi32.dll")]
extern static int NetUserDel([MarshalAs(UnmanagedType.LPWStr)] string servername, [MarshalAs(UnmanagedType.LPWStr)] string username);
[DllImport("Netapi32.dll")]
extern static int NetUserGetInfo([MarshalAs(UnmanagedType.LPWStr)] string servername, [MarshalAs(UnmanagedType.LPWStr)] string username, int level, out IntPtr bufptr);
[DllImport("Netapi32.dll")]
extern static int NetUserSetInfo([MarshalAs(UnmanagedType.LPWStr)] string servername, [MarshalAs(UnmanagedType.LPWStr)] string username, int level, ref USER_INFO_1 buf, int error);
[DllImport("Netapi32.dll")]
extern static int NetUserChangePassword([MarshalAs(UnmanagedType.LPWStr)] string domainname, [MarshalAs(UnmanagedType.LPWStr)] string username, [MarshalAs(UnmanagedType.LPWStr)] string oldpassword, [MarshalAs(UnmanagedType.LPWStr)] string newpassword);
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct USER_INFO_0
{
public String Username;
}
[DllImport("Netapi32.dll")]
extern static int NetUserEnum([MarshalAs(UnmanagedType.LPWStr)] string servername, int level, int filter, out IntPtr bufptr, int prefmaxlen, out int entriesread, out int totalentries, out int resume_handle);
[DllImport("Netapi32.dll")]
extern static int NetApiBufferFree(IntPtr Buffer);
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LOCALGROUP_USERS_INFO_0
{
public string groupname;
}
[DllImport("Netapi32.dll")]
public extern static int NetUserGetLocalGroups([MarshalAs(UnmanagedType.LPWStr)] string servername, [MarshalAs(UnmanagedType.LPWStr)] string username, int level, int flags, out IntPtr bufptr, int prefmaxlen, out int entriesread, out int totalentries);
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct USER_INFO_1
{
public string usri1_name;
public string usri1_password;
public int usri1_password_age;
public int usri1_priv;
public string usri1_home_dir;
public string comment;
public int usri1_flags;
public string usri1_script_path;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LOCALGROUP_INFO_1
{
public string grpi1_name;
public string grpi1_comment;
}
/// <summary>
/// 添加一个用户，添加失败后返回非0 。
/// </summary>
/// <param name="serverName">机器名称，如果是本机，请设置为null</param>
/// <param name="userName"></param>
/// <param name="password"></param>
/// <param name="strComment"></param>
public void AddUser(string serverName, string userName, string password, string strComment)
{
USER_INFO_1 NewUser = new USER_INFO_1(); //创建一个USER_INFO_1实例
NewUser.usri1_name = userName; // Allocates the username
NewUser.usri1_password = password; // allocates the password
NewUser.usri1_priv = 1; // Sets the account type to USER_PRIV_USER
NewUser.usri1_home_dir = null; // We didn't supply a Home Directory
NewUser.comment = strComment; // Comment on the User
NewUser.usri1_script_path = null; // We didn't supply a Logon Script Path
if (NetUserAdd(serverName, 1, ref NewUser, 0) != 0) //添加失败后返回非0
{
MessageBox.Show("Error Adding User", "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
/// <summary>
/// 添加一个用户，添加失败后返回非0 。
/// </summary>
/// <param name="serverName">机器名称，如果是本机，请设置为null</param>
/// <param name="groupName"></param>
/// <param name="strComment"></param>
public void AddGroup(string serverName, string groupName, string strComment)
{
LOCALGROUP_INFO_1 NewGroup = new LOCALGROUP_INFO_1();
NewGroup.grpi1_name = groupName;
NewGroup.grpi1_comment = strComment;
if (NetLocalGroupAdd(serverName, 1, ref NewGroup, 0) != 0) //添加失败后返回非0
{
MessageBox.Show("Error Adding Group", "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
/// <summary>
/// 在本地组中添加一个用户成员，添加失败后返回非0 。
/// </summary>
/// <param name="serverName">机器名称，如果是本机，请设置为null</param>
/// <param name="groupName"></param>
/// <param name="strComment"></param>
public void GroupAddMembers(string serverName, string groupName, string userName)
{
LOCALGROUP_MEMBERS_INFO_3 NewMember = new LOCALGROUP_MEMBERS_INFO_3();
NewMember.domainandname = userName;
if (NetLocalGroupAddMembers(serverName, groupName, 3, ref NewMember, 1) != 0) //添加失败后返回非0
{
MessageBox.Show("Error Adding Group Member", "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
/// <summary>
/// 删除一个用户，同时将删除这个用户在任何组中的关系，删除失败后返回非0。
/// </summary>
/// <param name="serverName">机器名称，如果是本机，请设置为null</param>
/// <param name="userName"></param>
public void RemoveUser(string serverName, string userName)
{
if (NetUserDel(serverName, userName) != 0) //删除失败后返回非0
{
MessageBox.Show("Error Removing User", "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
/// <summary>
/// 获取一个用户的信息，失败后返回非0。
/// </summary>
/// <param name="serverName">机器名称，如果是本机，请设置为null</param>
/// <param name="userName"></param>
public void GetUserInfo(string serverName, string userName)
{
IntPtr bufPtr;
USER_INFO_1 User = new USER_INFO_1();
if (NetUserGetInfo(serverName, userName, 1, out bufPtr) != 0)
{
MessageBox.Show("Error Getting User Info", "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
User = (USER_INFO_1)Marshal.PtrToStructure(bufPtr, typeof(USER_INFO_1));
MessageBox.Show("Users Name: " + User.usri1_name + "\nUsers Comments: " + User.comment + "\nUsers Privilege Level: " + User.usri1_priv + "\nUsers flags: " + User.usri1_flags + "\nUsers home dir: " + User.usri1_home_dir);
}
/// <summary>
/// 修改一个用户，失败后返回非0。这儿我只做了简的测试，如果要修改用户更多的信息，请加上其它信息。
/// </summary>
/// <param name="serverName">机器名称，如果是本机，请设置为null</param>
/// <param name="userName"></param>
public void ModifyUser(string serverName, string userName)
{
USER_INFO_1 Update = new USER_INFO_1();
Update.comment = "This is Our C# Updated Comment";
//Update.usri1_priv = 2; // Note that this can only be obtained programmatically using NetUserGetInfo
if (NetUserSetInfo(serverName, userName, 1, ref Update, 0) != 0)
{
MessageBox.Show("Error Setting User Info", "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
/// <summary>
/// 修改一个用户的密码，失败后返回非0。
/// </summary>
/// <param name="serverName">机器名称，如果是本机，请设置为null</param>
/// <param name="userName"></param>
public void ModifyUserPassword(string serverName, string userName, string oldPassword, string newPassword)
{
if (NetUserChangePassword(serverName, userName, oldPassword, newPassword) != 0)
{
MessageBox.Show("Error Changing User Password", "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
/// <summary>
/// 获取机器上所有的用户信息。
/// </summary>
/// <param name="serverName">机器名称，如果是本机，请设置为null</param>
public void GetAllUserInfo(string serverName)
{
int EntriesRead;
int TotalEntries;
int Resume;
IntPtr bufPtr;
NetUserEnum(serverName, 0, 2, out bufPtr, -1, out EntriesRead, out TotalEntries, out Resume);
if (EntriesRead > 0)
{
USER_INFO_0[] Users = new USER_INFO_0[EntriesRead];
IntPtr iter = bufPtr;
for (int i = 0; i < EntriesRead; i++)
{
Users[i] = (USER_INFO_0)Marshal.PtrToStructure(iter, typeof(USER_INFO_0));
iter = (IntPtr)((int)iter + Marshal.SizeOf(typeof(USER_INFO_0)));
MessageBox.Show(Users[i].Username);
}
NetApiBufferFree(bufPtr);
}
}
/// <summary>
/// 获取机器上某用户所属于的本地组信息。
/// </summary>
/// <param name="serverName">机器名称，如果是本机，请设置为null</param>
/// <param name="userName"></param>
public void UserInLocalGroups(string serverName, string userName)
{
int EntriesRead;
int TotalEntries;
IntPtr bufPtr;
NetUserGetLocalGroups(serverName, userName, 0, 0, out bufPtr, 1024, out EntriesRead, out TotalEntries);
if (EntriesRead > 0)
{
LOCALGROUP_USERS_INFO_0[] RetGroups = new LOCALGROUP_USERS_INFO_0[EntriesRead];
IntPtr iter = bufPtr;
for (int i = 0; i < EntriesRead; i++)
{
RetGroups[i] = (LOCALGROUP_USERS_INFO_0)Marshal.PtrToStructure(iter, typeof(LOCALGROUP_USERS_INFO_0));
iter = (IntPtr)((int)iter + Marshal.SizeOf(typeof(LOCALGROUP_USERS_INFO_0)));
MessageBox.Show(RetGroups[i].groupname);
}
NetApiBufferFree(bufPtr);
}
}
}
}
代码
